Respuestas de la API Open Banking

Cuentas

Las cuentas son los repositorios donde se almacenan las transacciones de los usuarios finales, las cuales se clasifican de acuerdo con sus características, como el tipo y/o el número de cuenta. La información de las cuentas y transacciones puede recuperarse de sitios de terceros y se actualiza cada vez que se sincronizan las credenciales a las que pertenecen.
Campo Descripción
id_account Identificador único de la cuenta.
is_disable Bandera de estado, indica si la cuenta aparece como deshabilitada en el sitio o si la cuenta ya no se encuentra en el sitio.
name Nombre de la Cuenta
number Número de la Cuenta
balance Balance de la Cuenta entregado por el sitio.
  • Cuando la cuenta es de crédito, el balance aparece como negativo
currency Código de moneda (ISO 4217).
account_type Tipo de cuenta, esta puede ser:
  • Cheques
  • Ahorro
  • Crédito
  • Inversión
  • Fiscal
  • Servicios
  • Cartera digital
  • Hipoteca
  • Préstamo
extra Información extra obtenida del sitio (si hay información disponible, se creará una llave con el valor indicado, de otra forma, se omitirá).

Los posibles valores son:
  • owner : Nombre del propietario de la Cuenta
  • owner_address : Domicilio del propietario de la Cuenta
  • owner_identifier : Identificador del propietario: RFC, CUIT, etc.
  • contract : Nombre o Número de Contrato de la Cuenta
  • available : Crédito disponible (Para Cuentas de Crédito)
  • limit : Límite de crédito (Para Cuentas de Crédito)
  • minimum : Pago mínimo de la Cuenta (Para Cuentas de Crédito)
  • no_interest : Pago mínimo para no generar intereses (Para Cuentas de Crédito)
  • annual_fee : Comisión anual (Para Cuentas de Crédito)
  • points : Puntos de recompensa (Para Cuentas de Crédito)
  • miles : Millas de recompensa (Para Cuentas de Crédito)
  • last_statement_date: Fecha de Corte, puede aparecer sólo como día de corte, es necesario construir una fecha con ese día tomando el mes actual. (Para Cuentas de Crédito)
  • next_payment_date : Fecha de Cobro, puede aparecer como Fecha de Pago o Fecha Límite de Pago(Para Cuentas de Crédito)
  • last_payment_date : Fecha de último Pago (Para Cuentas de Crédito)
  • last_statement_balance: Saldo del último periodo (Para Cuentas de Crédito)
  • pending_balance: Balance Pendiente (Para Cuentas de Crédito)
  • complete_balance: CLABE Balance Confirmado o Balance Retenido (Para Cuentas de Crédito)
  • wire_transfer_number :Número de transferencia bancaria.
  • transfer_number :Número de Transferencia
  • principal_balance :Balance principal del préstamo (Para Cuentas de Préstamo)
  • origination_date :Fecha en la que se originó el préstamo (Para Cuentas de Préstamo)
  • loan_term :Plazo del préstamo en meses (Para Cuentas de Préstamo)
  • total_number_of_payments :Número total de pagos (Para Cuentas de Préstamo)
  • clabe : CLABE (Clave Bancaria Estandarizada)
site [id_site: ID del sitio, name: nombre del sitio, avatar: avatar del sitio, cover: cover del sitio, small_cover: cover pequeño del sitio].
dt_refresh Fecha de la última actualización de la cuenta dentro de Syncfy.

Transacciones

Las transacciones son los movimientos financieros que están relacionados con una cuenta, y reflejan el ingreso o egreso que el usuario final tiene en determinado sitio. La cantidad de información histórica que Sync puede recuperar al crear una credencial por primera vez varía dependiendo de la fuente pero, por lo general, estarán disponibles las transacciones de 60 días previos. A partir de ahí se va creando un historial con sincronizaciones diarias.
Campo Descripción
id_transaction Identificador único de la transacción
id_account Identificador de la cuenta a la cual pertenece la transacción.
id_account_type Código del tipo de cuenta, este puede ser:
  • Cheques
  • Ahorro
  • Crédito
  • Inversión
  • Fiscal
  • Servicios
  • Cartera digital
  • Hipoteca
  • Préstamo
is_disable Bandera de estado, indica si una transacción ha dejado de ser vigente o ya no se encontró en el sitio.
description Descripción de la transacción ó concepto.
amount Monto de la transacción.
reference Referencia de la transacción (si está disponible).
currency Código de moneda (ISO 4217).
dt_transaction Fecha de transacción en UNIX timestamp.
extra Información extra obtenida del sitio (si hay información disponible, se creará una llave con el valor indicado, de otra forma, se omitirá).

Los posibles campos son:
  • spei_concept : Concepto SPEI
  • spei_reference_number : Número de Referencia SPEI
  • spei_track_number : Clave de Rastreo SPEI
  • spei_transmitter : Nombre del Banco Emisor
  • spei_transmitter_name : Nombre del Ordenante
  • spei_transmitter_account : CLABE del Ordenante
  • spei_transmitter_tax_id : RFC del Ordenante
  • spei_beneficiary : Nombre del Banco Receptor
  • spei_beneficiary_name : Nombre del Beneficiario
  • spei_beneficiary_account : CLABE del Beneficiario
  • spei_beneficiary_tax_id : RFC del Beneficiario
  • dt_authorization : Fecha de autorización de la Transacción
  • dt_application : Fecha de aplicación de la Transacción
  • dt_operation: Fecha de operación de la Transacción
  • caption : Propiedad para almacenar una descripción alternativa de la transacción
  • caption2 : Segunda descripción de la transacción
  • caption3 : Tercera descripción de la transacción
  • caption4 : Cuarta descripción de la transacción
  • concept : Concepto de Transacción cuando tiene una descripción y concepto.
  • spei : Propiedad para almacenar la información de SPEI cuando viene concatenada
  • tax_id : Receptor / Emisor del CFDI
  • balance : Balance de la Cuenta después del Movimiento
  • order : Número que indica el orden de la aparición de la Transacción en el portal, comenzando por la Transacción más reciente. El order se reinicia por Cuenta.
  • card_number : Indica la tarjeta con la que se realizó el movimiento cuando aparece en el portal
  • voucher_number: Número del comprobante
  • group_of_concept: Grupo del concepto
  • terminal_number: Número de la Terminal
  • card_holder_name: Nombre del titular de la tarjeta
  • merchant: Comercio
  • branch: Sucursal del banco donde el movimiento se realizó
  • sequential: Campo que se utiliza cuando el banco especifica un valor "consecutivo"
  • categories: Categoría a la que se asigna la transacción
dt_refresh Fecha de la última actualización de la transacción en Syncfy.
dt_disable Fecha en que la transacción fue deshabilitada.