Skip to content

Enabling JustOn Bank Payments

Your business may use JustOn Bank Payments to directly integrate Salesforce CRM with German or other European banks.

Integration Concepts

The payment functionality shipped with JustOn Bank Payments is centered around entries (see Important App Concepts). These records hold all information with respect to an amount of money owed to or requested by a business partner, based on statements that justify the corresponding request.

In JustOn Billing & Invoice Management, the produced invoices or – if set up and used – installments represent payment requests. Now integrating JustOn Billing & Invoice Management with JustOn Bank Payments provides for the creation of the relevant entry records upon invoice finalization or installment creation.

jpay_jo_integration
Creating entries on invoice finalization or installment creation

Preconditions

The integration requires JustOn Bank Payments to be set up properly. For details, see Setting Up JustOn Bank Payments.

The integration requires the payment method SEPA to be set up in JustOn Billing & Invoice Management. For details, see Enabling Payment Method SEPA.

Configuring Data Relations

Enabling Lookup

As entries are always linked to the original statements, you must allow for relating the produced entries with the original invoices or statements. To this end, you create lookup fields on the Entry object.

  1. Navigate to the fields list of the Entry object.
  2. Create the following new fields.

    Label API Name Data Type Description
    Invoice Invoice Lookup (Invoice) Links to the related invoice.
    Must be writable.
    Installment Payment Lookup (Payment) Links to the related installment (Payment object).
    Must be writable.

Enabling PDF Preview

Entries provide a public link to the PDF of the original statement. To support this, you must set up the corresponding public file link generation for invoices. This involves enabling the content distribution and creating the PDF preview URL field.

To enable the content distribution:

  1. In Setup, open Custom Settings.

    In Salesforce Lightning, navigate to Custom Code > Custom Settings.

    In Salesforce Classic, navigate to Develop > Custom Settings.

  2. Click Manage in the row of Global Settings.

  3. Click Edit in the Default row.
  4. Select the checkbox Always Create Content Distribution.
  5. Click Save.

To create the PDF preview URL field:

  1. Navigate to the fields list of the Invoice object.
  2. Create the following new field.

    API Name Data Type Description
    ContentDistributionUrl URL Specifies the public link to the PDF preview.
    Make sure to grant edit access for all users who finalize invoices.

Once set up, this will copy the value from the Content Distribution URL field on the invoice to the Statement Distribution URL on the produced entry.

Activating Integration

To activate the integration with JustOn Bank Payments, enable the corresponding global setting:

  1. In Setup, open Custom Settings.

    In Salesforce Lightning, navigate to Custom Code > Custom Settings.

    In Salesforce Classic, navigate to Develop > Custom Settings.

  2. Click Manage in the row of Global Settings.

  3. Click Edit in the Default row.
  4. Select the checkbox Enable JustOn Bank Payments.
  5. Click Save.

Data Mapping

Entries hold all information with respect to an amount of money owed to or requested by a business partner. The entries' data is based on invoice data or on installments data and, if applicable, on already received payments. If a payment plan is modified after the invoice finalization producing new installments, the existing entry records are deleted, and new entry records are created accordingly.

The following fields are set on entry creation:

Data Category Entry Field Invoice Source Field Installment Source Field Default Value/Notes
General Type Debit for positive amount
Credit for negative amount
Title Invoice: custom label with invoice number
Installment: custom label with title and invoice number
Payment Reference String built as defined in the Payment Reference field of the template, see Configuring Payment Reference Text
Business Entity Tenant Invoice__r.Tenant The business entity record in JustOn Bank Payments is modified or created on entry record creation using the values given by the invoice.
Requests Requested Payment Method PaymentMethod Invoice__r.PaymentMethod
Requested Payment Provider PaymentProvider Invoice__r.PaymentProvider Optional lookup to JPAY1__PaymentProvider
Requested Payment Instrument PaymentInstrument Invoice__r.PaymentInstrument Optional lookup to JPAY1__PaymentInstrument
Requested Bank Account BankAccount Invoice__r.BankAccount Optional lookup to JPAY1__BankAccount
Customer Data BP Number DebtorNo or
Account__r.ON_DebtorNo
Invoice__r.DebtorNo or
Invoice__r.Account__r.ON_DebtorNo
Optional
BP Type Debtor
Account Account Invoice__r.Account
Account Name AccountName Invoice__r.AccountName
Contact EmailContact Invoice__r.EmailContact
Statement Data Statement Type Invoice | Installment
Statement Description
Statement No Name Invoice__r.Name
Invoice Id Invoice Lookup to entry source
Installment Id Lookup to entry source
Statement Distribution URL ContentDistributionUrl Invoice__r.ContentDistributionUrl
Dates Statement Date Date Invoice__r.Date
Statement Payment Due Date NextPaymentDueDate Date
Service Period Start ServicePeriodStart ServicePeriodStart
Service Period End ServicePeriodEnd ServicePeriodEnd
Amount Status Status PaymentStatus Open Open
Paid Balanced
Open Amount NextPaymentDue OpenPaymentAmount