Vinculación de Cuentas

La Vinculación de Cuentas te permite asociar (o vincular) cualquier par de cuentas para que se activen movimientos automáticos cuando se registre un crédito.

Entendiendo las cuentas primarias y secundarias

Una cuenta primaria es cualquier cuenta, Cobre Balance o contraparte a donde los fondos serán redirigidos automáticamente. Esta cuenta recibirá fondos automáticos de una cuenta secundaria. Deberás declararla al crear un Cobre Balance

Una cuenta primaria puede tener múltiples cuentas secundarias

Una cuenta secundaria es el Cobre Balance que está configurado para mover fondos automáticamente a una cuenta primaria

Una cuenta secundaria solo puede estar asociada con una cuenta primaria

Combinaciones válidas

Las siguientes combinaciones están permitidas al vincular una cuenta

Colombia

México

Cuenta secundaria	Tipo permitido secundario	Proveedor permitido secundario	Cuenta primaria	Tipo permitido primario	Proveedor permitido primario	Flujo MM	Tipo MM generado
account_id	cobre_balance	pr_col_cobre	counterparty_id o account_id	corriente (cc), ahorro (ch), depósito electrónico (dp), o Cobre Balance	Cualquiera	PUSH	ACH, fast_pay o Bre-B

Las contrapartes de Cobre Balance no están permitidas como cuentas primarias

Flujo de Movimiento de Dinero para Cuentas Vinculadas

Después de vincular una cuenta primaria a una cuenta secundaria, ocurrirá el siguiente flujo de fondos:

Recepción de Transacción: Se recibe una transacción en la cuenta secundaria, la cual se reflejará como una transacción de crédito.

Procesamiento de Movimiento de Dinero: La cuenta secundaria iniciará un Movimiento de Dinero hacia la cuenta primaria. Este movimiento de dinero incluirá el transaction_id de la transacción de crédito inicial. Si es exitoso, se registrarán las siguientes transacciones:

2.1. Se registrará un débito de transacción en la cuenta secundaria.

2.2. Se registrará un crédito de transacción en la cuenta primaria.

Ten en cuenta: Si el movimiento automático de dinero hacia la cuenta primaria falla, los fondos permanecerán en la cuenta secundaria y deben ser gestionados manualmente por el cliente

Acciones Permitidas en Vinculación de Cuentas

🔗 Configurar cuentas vinculadas

✍️ Asignar o cambiar cuentas primarias

⛓️‍💥 Desvincular cuenta primaria

Descripción: Al crear una cuenta Cobre Balance y establecer una cuenta primaria en la sección de metadatos, se genera automáticamente el vínculo con la cuenta primaria.

Qué esperar después de la acción: Los fondos recibidos en la cuenta Cobre Balance serán redirigidos a la cuenta primaria asociada durante la creación del Cobre Balance.

📘 Aprende más: 🔗 Crear un Cobre Balance

Cómo Empezar

Para crear cuentas vinculadas, debes asociar una cuenta primaria a una cuenta secundaria. Esto se puede hacer declarándola dentro de los metadatos al crear la cuenta

Antes de usar esta API

Selecciona una cuenta primaria con un proveedor válido

Este es el Cobre Balance o Contraparte que recibirá automáticamente los fondos acreditados al Cobre Balance que lo vincule.

Configura, cambia o desvincula una cuenta primaria por primera vez

Crea un nuevo Cobre Balance cuya cuenta primaria sea el Cobre Balance o Contraparte designado para tal propósito.

Suscríbete a las notificaciones de transacciones

Suscríbete a los eventos requeridos para recibir notificaciones sobre créditos de transacciones o estado de movimientos de dinero, como accounts.balance.credit o money_movements.status.completed

Qué esperar después de usar esta API

Recepción de Transacción

Cuando se recibe una transacción en la cuenta secundaria (ej., pago PSE en Colombia o una transferencia SPEI en México), se reflejará como una transacción de crédito (ej., col_credit en Colombia, spei_credit en México)

Procesamiento de Movimiento de Dinero

Después de la recepción de la transacción, la cuenta secundaria iniciará un Movimiento de Dinero hacia la cuenta primaria. Este movimiento de dinero incluirá el transaction_id de la transacción de crédito inicial (ej., external_id = transaction_id).

2.1 Registro de Transacción de Débito

Se registrará una transacción de débito en la cuenta secundaria una vez que se procese el movimiento de dinero. (ej., col_cb_debit en Cobre Balance de Colombia, spei_debit en Cobre Balance de México)

2.2 Registro de Transacción de Crédito

Se registrará una transacción de crédito en la cuenta primaria reflejando la transferencia de fondos. (ej., col_cb_credit en Cobre Balance de Colombia, spei_credit en Cobre Balance de México)

Ten en cuenta que si la acción a realizar es desvincular, los pasos 2, 2.1 y 2.2 ya no se ejecutarán, y los fondos permanecerán en la cuenta secundaria.

Vinculación de Cuentas

Entendiendo las cuentas primarias y secundarias#

Combinaciones válidas#

Flujo de Movimiento de Dinero para Cuentas Vinculadas#

Acciones Permitidas en Vinculación de Cuentas#

Cómo Empezar#

Antes de usar esta API#

Qué esperar después de usar esta API#

Entendiendo las cuentas primarias y secundarias

Combinaciones válidas

Flujo de Movimiento de Dinero para Cuentas Vinculadas

Acciones Permitidas en Vinculación de Cuentas

Cómo Empezar

Antes de usar esta API

Qué esperar después de usar esta API