Banking services codes

The following sections explain the conventions used in the banking services we offer.

Bank transaction codes

In Open Banking services, the Transaction object may contain the BankTransactionCode element, which is used to identify the type of the transaction. It is composed of a Code and a SubCode, with values based on the ISO 20022 Standard, designed for financial activities.

It is of particular interest to observe the message definitions contained in the documents linked in the External code sets message catalog, as these are the basis of the codes used in the response messages.

Please refer to the Bank Transaction Code combinations and Bank Transaction Code description links, where you can download the latest version of each document containing the code definitions.

Currency codes for service names

As for the currency types, they are specified next to the name of the service and are present in the path of the operation. This naming standard only applies to the path, as the response objects have their own Currency field with the acronym of the currency type (CLP, USD, etc.).

The codes are as follows:

• LCY (Local Currency): The service only sends data in the currency used in the country where the bank operates.
• FCY (Foreign Currency): The service will not send data in local currency, but only in the foreign currency given as a request parameter.
• ACY (Any Currency): The service can respond in more than one currency, corresponding to the one used as a request parameter. It can access both local and foreign currencies as well.

Each bank service name will be identified by the type of currency based on its country of origin, so for Chilean banks, services with LCY will only return information in Chilean Pesos (CLP).

Booked vs Pending transactions

Below are the official Open Banking definitions for the possible status of a transaction.

Booked

Booked means that the transfer of funds has been completed between the account servicer and the account holder.

Usage: The Booked status does not necessarily mean that the funds are finalized, as this depends on other factors such as the payment system used, the completion of the end-to-end transaction and the terms agreed between the account servicer and the owner. Booked status is the only status that can be reversed.

Pending

Booking on the account owner's account in the account servicer's ledger has not been completed.

Usage: This can be used for expected items or for items for which some conditions have to be fulfilled before they can be posted. If the entry is posted, it will be included with the status Booked in the next account report or statement. The Pending status cannot be reversed.

⚠️ Please note that for Chilean banks, transactions will always be returned with the "Status": "Booked", as all transactions are considered posted immediately upon creation.