Skip to content

Enabling Data Retrieval From figo

JustOn integrates with figo to retrieve banking transactions, which are to be stored as payment entries.

Info

The figo integration is available as of JustOn 2.55 and requires at least the Salesforce Enterprise Edition.

Prior to using the figo service, your organization must conclude a contract with figo.

Reference: figo Data Conversion

figo stores banking transactions in the figo Connect Transaction object. Upon data transfer, JustOn automatically maps the retrieved transaction JSON data to the Payment Entry object.

The following table shows which data is written to the payment entry.

Payment Entry Field Value Description
ExternalTransactionId__c FIGO + <transaction_id> External ID that is used to uniquely match a figo transaction
TransactionNo__c <transaction_id> Internal figo transaction ID
PaymentProvider__c figo Name of the payment provider
Status__c New Status for newly created objects
Debit__c <amount> if the value is positive The debit amount
Credit__c <amount> if the value is negative The credit amount
Reference__c <purpose> Purpose text, can be empty if the transaction has no purpose
CustomerName__c <name> Name of originator or recipient
BankAccountId__c <account_id> Internal figo account ID
BookingDate__c <booking_date> Booking date
ProviderSpecificData__c complete transaction JSON data The retrieved figo transaction JSON data for this object

The figo Connect Transaction Object JSON data contains a number of additional fields. JustOn can write additional data values to custom fields of the payment entry. Each JSON value is processed in the following way:

(1) The JSON field name is converted to a Salesforce field name, where

  • underscores are removed,
  • if the JSON value belongs to a child object, the field name is prefixed with the field name of the parent object, connected by an underscore,
  • the string FIGO_ is prepended,
  • the string __c is appended.

(2) If there is a matching field on the Payment Entry object, the field value is written to this field.

(3) The type of the Payment Entry field must match the type of the JSON field value, like Text (255) for bank_name, Currency for amount or Date for value_date. JustOn automatically converts the JSON value to the type of the Payment Entry field.

Example field conversions

JSON Field Salesforce field name Type
account_number FIGO_AccountNumber__c Text (255)
value_date FIGO_ValueDate__c Date
end_to_end_reference FIGO_EndToEndReference__c Text (255)
additional_info.gross_amount FIGO_AdditionalInfo_GrossAmount__c Currency (13,5)

When retrieving figo transactions from the banking server, the response may contain a list of deleted transactions. For these transactions, JustOn also creates payment entries with the following data:

Payment Entry Field value Description
ExternalTransactionId__c FIGO + <transaction_id> External ID that is used to uniquely match a figo transaction
TransactionNo__c <transaction_id> Internal figo transaction ID
PaymentProvider__c figo Name of the Payment Provider
Status__c New Status for newly created objects
IsDeleted__c true Indicates that the corresponding transaction is deleted

Enabling the data retrieval from the figo banking service involves

Adding Data Retrieval Button

To enable the option for retrieving banking transaction data from figo, add the Retrieve figo Transactions button to the payment entry list view. To do so:

  1. Navigate to the object management settings of the Payment Entry object.
  2. Click Search Layouts.
  3. Click Edit in the row of the List View.
  4. In the Custom Buttons section, move Retrieve figo Transactions to the Selected Buttons column.
  5. Click Save to save the modified page layout.

Adding Authorization Button

To enable the option for forcing the authorization with figo, add the Force figo Authorization button to the payment entry list view. To do so:

  1. Navigate to the object management settings of the Payment Entry object.
  2. Click Search Layouts.
  3. Click Edit in the row of the List View.
  4. In the Custom Buttons section, move Force figo Authorization to the Selected Buttons column.
  5. Click Save to save the modified page layout.