The following sections details conventions used in the banking services we offer.
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.
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 (
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).
Below are the official Open Banking definitions for the possible transaction status'.
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.
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.