Banking services code
The following sections details conventions used in the banking services we offer.
Bank transaction codes
In Open Banking services, the Transaction
object can contain the BankTransactionCode
element, which is used to identify the type of the transaction. It is comprised of a Code
and a SubCode
, with values based on the ISO 20022 Standard, designed for financial activities.
It is of special interest to observe the messaging 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 with the code definitions.
Currency codes for service naming
Regarding the currency types, they are specified alongside the name of the service and are present in the operation's path. This naming standard applies only to the path, as the response objects have their own field Currency
with the acronym of the type of currency (CLP
, USD
, etc.).
The codes are as follows:
- LCY (Local Currency): The service only send data with the currency used in the country where the bank is operating.
- FCY (Foreign Currency): The service does not send data in local currency, only in the foreign currency passed as a request parameter.
- ACY (Any Currency): The service can respond in more than one currency, corresponding the one used as a request parameter. It can access local and foreign currencies as well.
Each bank service name will be identified by the type of currency based in its country of origin, so for Chilean banks, services with LCY only return information in Chilean Pesos (CLP).
Booked vs Pending transactions
Below are the official Open Banking definitions for the possible transaction status'.
Booked
Booked means that the transfer of money has been completed between account servicer and account owner
Usage: Status Booked does not necessarily imply finality of money 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 account servicer and owner. Status Booked 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 still need to be fulfilled before they can be booked. If booking takes place, the entry will be included with status Booked in subsequent account report or statement. Status Pending cannot be reversed.