Códigos de los servicios bancarios
En las siguientes secciones se detallan las convenciones utilizadas en los servicios bancarios que ofrecemos.
Códigos de transacciones bancarias
En los servicios de Open Banking, el objeto Transaction
puede contener el elemento BankTransactionCode
, que se utiliza para identificar el tipo de transacción. Está compuesto por un Code
y un SubCode
, con valores basados en la Norma ISO 20022, diseñada para actividades financieras.
Es de especial interés observar las definiciones de mensajería contenidas en los documentos enlazados en el External code sets message catalog, ya que son la base de los códigos utilizados en los mensajes de respuesta.
Consulte los enlaces Combinaciones de códigos de transacciones bancarias y Descripción de códigos de transacciones bancarias, donde podrá descargar la última versión de cada documento con las definiciones de los códigos.
Códigos de moneda para la denominación de servicios
En cuanto a los tipos de moneda, se especifican junto al nombre del servicio y están presentes en la ruta de la operación. Esta norma de denominación sólo se aplica a la ruta, ya que los objetos de respuesta tienen su propio campo Moneda
con las siglas del tipo de moneda (CLP
, USD
, etc.).
Los códigos son los siguientes:
- LCY (Moneda Local): El servicio sólo envía datos con la moneda utilizada en el país donde opera el banco.
- FCY (Moneda extranjera): El servicio no envía datos en moneda local, sólo en la moneda extranjera pasada como parámetro de la petición.
- ACY (Cualquier moneda): El servicio puede responder en más de una moneda, correspondiendo la utilizada como parámetro de petición. También puede responder en moneda local y extranjera.
Cada nombre de servicio bancario será identificado por el tipo de moneda en base a su país de origen, por lo que para los bancos chilenos, los servicios con LCY sólo devolverán información en Pesos Chilenos (CLP).
Transacciones reservadas vs pendientes
A continuación se presentan las definiciones oficiales de Open Banking para el posible estado de una transacción.
Reservada
Reservada significa que la transferencia de dinero ha sido completada entre el administrador de la cuenta y el dueño de la cuenta.
Utilización: El estado Reservado no implica necesariamente que el dinero sea definitivo, ya que esto depende de otros factores como el sistema de pago utilizado, la finalización de la transacción de principio a fin y las condiciones acordadas entre el gestor y el titular de la cuenta. El estado Reservado es el único que puede anularse.
Pendiente
La anotación en la cuenta del titular en el libro mayor del administrador de la cuenta no se ha completado.
Utilización: puede utilizarse para partidas previstas o para partidas para las que aún deben cumplirse algunas condiciones antes de que puedan reservarse. Si se realiza el asiento, éste se incluirá con el estado Registrado en el informe o extracto de cuenta posterior. El estado Pendiente no puede anularse.
⚠️ Tenga en cuenta que para los bancos chilenos las transacciones siempre serán devueltas con
Estado "Registrado"
ya que todas las transacciones se consideran registradas inmediatamente después de su creación.