Skip to content

Initializing Banking Operations

JustOn Cash Management can integrate your Salesforce org with your bank in order to exchange payment information.

Info

Prior to using the banking connection of JustOn Cash Management, your business must enter into a (usually chargeable) contract on the intended data access with your bank. The contract must specify, among others, the users who work with the software and the relevant bank accounts.

Please consider the banking-related specifics and conditions summarized in Banking Preconditions.

How does the EBICS initialization take place?

Generally, EBICS initialization means exchanging public keys: You send your public subscriber keys to your bank, and your bank sends their public bank keys to you. Using the keys, you and your bank can then verify that any sent information – signed using the keys – is genuine.

The initialization procedure includes the following artifacts and procedure steps:

(1) EBICS access information
pay_app_init_bank1
After your organization has requested EBICS access, your bank sends a user letter to you. It includes the user data and other relevant access information for you to create the bank access.
(2) Electronic public subscriber keys
pay_app_init_bank2
As part of the bank access configuration, JustOn Cash Management creates your public subscriber keys and transfers them electronically to your bank.
(3) Printed public subscriber keys
pay_app_init_bank3
After adding the bank access, you are prompted to download the initialization letter, which includes your printed public subscriber keys. You send this document to your bank via postal mail or email.
(4) Public subscriber keys validation
pay_app_init_bank4
Your bank compares the public subscriber keys received electronically with the ones sent with the initialization letter.
(5) Printed public bank keys
pay_app_init_bank5
After your bank has verified the generated public subscriber keys for your bank access, it returns the confirmation letter via postal mail or email. This document includes the printed public bank keys.
Be aware that banks may also add the printed public bank keys to the user letter that includes the access information.
(6) Electronic public bank keys
pay_app_init_bank6
Once you have received the confirmation letter, you proceed to validate the public bank keys: This makes JustOn Cash Management fetch the public bank keys electronically.
(7) Public bank keys validation
pay_app_init_bank7
Now you compare the public bank keys received electronically with the ones sent with the confirmation letter.
Once you confirm the keys' validity, JustOn Cash Management completes the bank access setup. This makes the involved bank accounts ready for the EBICS-based data exchange with your bank.
pay_app_init_bank8

EBICS keys are valid for one year. If the keys are used (for uploading payment orders or retrieving bank statements) within the last 30 days of their validity, JustOn Cash Management automatically renews these keys, making them available for another year. If the expiry date has passed without renewing the keys, JustOn Cash Management disables the bank access, and users must repeat the EBICS initialization.

Initializing JustOn Cash Management for the proper EBICS-based operation with banks includes the following tasks:

Note

For the proper operation of JustOn Cash Management when handling bank access configurations, you must use a web browser that allows third-party cookies, like Mozilla Firefox, Google Chrome or Microsoft Edge.

Adding Bank Access

Before actually retrieving banking transactions, you must add the relevant bank access configuration to JustOn Cash Management.

Info

The bank accounts from which a user wants to fetch banking transactions must be subject to a corresponding contract with your bank. In this context, your bank provides the partner ID and the user ID, which are required for configuring the bank access.

  1. Click to access the App Launcher, and select Cash Management.
  2. On the Manage tab, click Add New Bank Access.

    For the proper operation of JustOn Cash Management when handling bank access configurations, you must use a web browser that allows third-party cookies, like Mozilla Firefox, Google Chrome or Microsoft Edge.

  3. Specify the bank access information.

    The required information includes:

    • Bank

      Banks are enabled by JustOn. If your bank is not listed, file a ticket in the JustOn Support Portal requesting to add the bank.

    • Partner ID, to be provided by your bank

    • User ID, to be provided by your bank

    pay_app_account_add
    Adding bank access information

  4. Click Continue.

    This adds the new bank access configuration as Pending and initiates the generation of your public subscriber keys. Once completed, you are prompted to download the initialization letter.

    pay_app_account_download.png
    Downloading initialization letter with your public subscriber keys

  5. Click Download.

    This opens the dialog for saving the initialization letter to your computer.

    Info

    Clicking Cancel closes this dialog without prompting you to download the initialization letter. You can, however, still download the initialization letter through clicking Initialization Letter on the pending bank access.

  6. Print the letter, sign it and send it to your bank.

    The bank will verify your public subscriber keys. In the EBICS context, this procedure is referred to as subscriber initialization.

Validating Keys

After your bank has verified the generated public subscriber keys for your bank access and returned the confirmation letter, you can proceed to validate the submitted public bank keys.

  1. Click to access the App Launcher, and select Cash Management.
  2. Open the Manage tab to access your bank access configurations.

    For the proper operation of JustOn Cash Management when handling bank access configurations, you must use a web browser that allows third-party cookies, like Mozilla Firefox, Google Chrome or Microsoft Edge.

  3. On the pending bank access, click Validate.

    This fetches the public bank keys from your bank.

  4. Compare the displayed keys with those in the confirmation letter.

    Note

    Make sure that the displayed public bank keys are identical to those in the confirmation letter received from your bank. If the keys differ, contact your bank.

    Be aware that any inconsistencies may indicate fraud or abuse.

  5. If the information matches, select the confirmation checkbox.

    pay_app_account_compare
    Displaying public bank keys for comparison

  6. Click Validate.

    This completes the bank access validation, making the involved bank accounts ready for bank data retrieval, direct debit order creation or credit transfer order creation.

Note

EBICS keys are valid for one year.

If the keys are used (for uploading payment orders or retrieving bank statements) within the last 30 days of their validity, JustOn Cash Management automatically renews these keys, making them available for another year. If the expiry date has passed without renewing the keys, JustOn Cash Management disables the bank access, and users must repeat the EBICS initialization.

Configuring Business Entity

In order to take part in the SEPA payment order exchange, your business needs a SEPA Creditor Identifier. This ID allows future debtors as well as debtor banks to identify a creditor independently from any relationship with a bank. For details about the ID, how to obtain it, etc., see Creditor Identifier Overview.

Once you have obtained the SEPA Creditor Identifier, you add it to the corresponding business entity.

  1. Click to access the App Launcher, and select Cash Management.
  2. Open the Business Entity tab.

    For easy access, you may want to add the Business Entity tab to the navigation bar. For details, see Personalize the Navigation Bar in the Salesforce Help.

  3. Click the business entity name to open its detail view and click Edit, or click New to create a new business entity.

  4. Specify the information as required.

    The mandatory information include:

    Field Description
    Company Name The legal name of the business entity
    Tax Id The tax (VAT) ID of the business entity
    SEPA Creditor Id The SEPA Creditor Identifier of the business entity
    Address The legal address of the business entity
    Preferred Bank Account The bank account for the money transfer
  5. Click Save.

    This completes the business entity configuration, preparing it for the direct debit order creation.

Enabling Credit Transfer

To enable the option for creating credit transfer orders, you may have to add the button EBICS Credit Transfer to the Entry list view manually. To do so:

  1. Click to enter Setup, then navigate to the object management settings of the Entry object.
  2. Click List View Button Layout.
  3. In the List View row, click , then select Edit.
  4. Under Custom Buttons, move EBICS Credit Transfer to the Selected Buttons column.

    pay_app_credit_btn

  5. Click Save.

Enabling Payment Statuses

To enable specific operations on payments, you may have to add the required Status values manually if you have upgraded JustOn Cash Management from an older version. To do so:

  1. Click to enter Setup, then navigate to the object management settings of the Payment object (JPAY1__Payment__c).
  2. Click Fields & Relationships.
  3. Click the name of the Status field.
  4. In the Values section, click New.

    Add the relevant status values, like Canceled, Failed, Pending, each in a new line.

    pay_app_payment_status_values

  5. Click Save.

    This saves the specified status values as required.

    For details about modifying the values of picklist fields, see Add or Edit Picklist Values in the Salesforce Help.