Conciliación de Linkage de Cuentas

Una cuenta primaria es un Cobre Balance, cuenta o contraparte donde se consolidan los fondos. Una cuenta secundaria es un Cobre Balance configurado para reenviar automáticamente cada crédito que recibe a su cuenta primaria. Esta guía cubre cómo conciliar la cadena de Movimientos de Dinero y Transacciones que produce el linkage, correlacionarla de vuelta con la colección original, y manejar los casos en que el barrido automático no ocurre.

Para cómo habilitar y configurar el link en sí, consulta Account Linkeage. Esta guía asume que el linkage ya está configurado y se enfoca en conciliar lo que produce.

La Cadena de Barrido Automático

Por cada crédito entrante en un balance secundario vinculado, Cobre genera una cadena fija de un Movimiento de Dinero y Transacciones en ambas cuentas — casi en tiempo real y por transacción, sin ventana de lotes:

El crédito llega al balance secundario

{
  "id": "trx_bC9k2QwXz7Ap",
  "type": "breb_credit",
  "account_id": "acc_SecondaryM01",
  "amount": 500000,
  "previous_balance": 0,
  "current_balance": 500000,
  "currency": "cop",
  "credit_debit_type": "credit",
  "transaction_date": "2026-08-19T14:02:10Z",
  "created_at": "2026-08-19T14:02:11Z",
  "metadata": {
    "key_value": "@MERCHANTONE",
    "sender_name": "JOHN DOE"
  }
}

Webhook: accounts.balance.credit (secundaria).

Cobre crea el Movimiento de Dinero automático

{
  "id": "mm_sWp84LtRq2Nx",
  "external_id": "trx_bC9k2QwXz7Ap",
  "geo": "col",
  "status": {
    "state": "completed",
    "code": "",
    "description": ""
  },
  "source_id": "acc_SecondaryM01",
  "destination_id": "acc_PrimaryCOP01",
  "currency": "cop",
  "amount": 500000,
  "created_at": "2026-08-19T14:02:12Z",
  "updated_at": "2026-08-19T14:02:14Z"
}

Webhook: money_movements.status.completed. Su external_id lleva el ID de la transacción del crédito original — este es el enlace que vincula el movimiento automático de vuelta a la colección que lo originó.

Se debita el balance secundario

{
  "id": "trx_sD3fGh81pQr",
  "type": "col_cb_debit",
  "account_id": "acc_SecondaryM01",
  "amount": -500000,
  "previous_balance": 500000,
  "current_balance": 0,
  "currency": "cop",
  "credit_debit_type": "debit",
  "transaction_date": "2026-08-19T14:02:13Z",
  "created_at": "2026-08-19T14:02:14Z",
  "metadata": {
    "money_movement_id": "mm_sWp84LtRq2Nx"
  }
}

Webhook: accounts.balance.debit (secundaria).

Se acredita el balance primario

{
  "id": "trx_pC7mNw92Ldz",
  "type": "col_cb_credit",
  "account_id": "acc_PrimaryCOP01",
  "amount": 500000,
  "previous_balance": 1200000,
  "current_balance": 1700000,
  "currency": "cop",
  "credit_debit_type": "credit",
  "transaction_date": "2026-08-19T14:02:14Z",
  "created_at": "2026-08-19T14:02:15Z",
  "metadata": {
    "money_movement_id": "mm_sWp84LtRq2Nx"
  }
}

Webhook: accounts.balance.credit (primaria). Esta es la pieza que confirma que los fondos ya están consolidados.

Si te suscribes a accounts.balance.credit, recibirás créditos para todos los balances, primarios y secundarios por igual. Distínguelos por content.account_id, no por la clave del evento.

Correlacionar la Cadena para Conciliación

Objeto	Campo de correlación	Valor
Transacción de crédito original	—	su propio `id`
Movimiento de Dinero automático	`external_id`	el `id` de la Transacción de crédito original
Transacción de débito secundaria	`metadata.money_movement_id`	el `id` del Movimiento de Dinero automático
Transacción de crédito primaria	`metadata.money_movement_id`	el `id` del Movimiento de Dinero automático

Para una colección Direct Link / R2P hacia un balance secundario, el mismo money_movement_id ya rastrea el crédito original y ambas piezas automáticas — no hay un enlace external_id separado que resolver.

Los PayOuts iniciados desde la cuenta primaria se concilian de la misma forma que cualquier otro PayOut en esta plataforma: mediante metadata.money_movement_id. Consulta Conciliación de PayOuts.

Tipos de Transacción por Geografía

Colombia:

Tipo	Significado
`col_cb_debit`	Se debita un Cobre Balance colombiano para transferir fondos a otro Cobre Balance
`col_cb_credit`	Un Cobre Balance colombiano recibe un crédito de otro Cobre Balance
`col_debit`	Transacción saliente hacia una institución financiera colombiana (p. ej., un PayOut local desde la cuenta primaria)
`col_credit`	Transacción entrante desde una institución financiera colombiana (p. ej., un PayOut rechazado que regresa a la cuenta primaria)

Aplicado al flujo de linkage: el débito secundaria → primaria es col_cb_debit y el crédito primaria correspondiente es col_cb_credit.

México: las piezas equivalentes usan spei_credit en la secundaria, el Movimiento de Dinero automático, spei_debit en la secundaria, y spei_credit en la primaria.

Consulta el catálogo completo de Tipos de Transacción para la lista completa.

Suscripción Mínima Viable de Webhooks

No necesitas los cuatro eventos para conciliar una colección de linkage:

Crédito secundario (accounts.balance.credit filtrado al account_id secundario) te indica que llegó un pago para un merchant determinado — registra la colección aquí.

Crédito primario (accounts.balance.credit filtrado al account_id primario) te indica que los fondos ya están consolidados.

El Movimiento de Dinero automático y el débito secundario son útiles para rastrear la cadena completa cuando algo parece incorrecto, pero no son necesarios para registrar la colección en sí. Trata el crédito primario como consolidación interna, no como un nuevo ingreso — el evento de ingreso es el crédito secundario.

Consulta Notificaciones y Suscripciones para cómo suscribirte y distinguir eventos por account_id.

Cuando el Barrido No Ocurre Automáticamente

Situación	Comportamiento
Se recibió un crédito en un balance secundario antes de que se configurara el linkage para él	No se barre retroactivamente — debe moverse manualmente.
El Movimiento de Dinero automático falla	Los fondos permanecen en el balance secundario; no hay reintento automático.
Un PayOut desde la cuenta primaria se completa y luego transiciona a un rechazo tardío	No se reversa automáticamente. Emite un reembolso como un nuevo Movimiento de Dinero desde la cuenta primaria — no queda vinculado a la transacción original.
Un PayOut desde la cuenta primaria es rechazado	Los fondos regresan a la cuenta primaria como una Transacción de crédito, con un evento `money_movements.status.rejected`.
Creación de un Cobre Balance	No existe ningún webhook para esto — confírmalo mediante la respuesta de creación o consultando la cuenta.
Distinguir una pieza de FX de un movimiento local	Un Movimiento de Dinero relacionado con FX lleva información de `fx_quote` en su `metadata`; los movimientos locales no.

Mover Fondos Manualmente

Cuando la conciliación revela un balance sin barrer, mueve los fondos con un Movimiento de Dinero ordinario entre tus propias cuentas:

POST /money_movements
{
  "source_id": "acc_SecondaryM01",
  "destination_id": "acc_PrimaryCOP01",
  "amount": 500000,
  "external_id": "manual-sweep-acc_SecondaryM01-2026-08-19",
  "metadata": {
    "description": "Secondary to Primary manual sweep"
  },
  "checker_approval": false
}

Esto también se puede hacer desde el Portal: Movimientos → Unitario → Mover Dinero → Enviar, seleccionando la cuenta secundaria como origen y la cuenta primaria (bajo Cuentas Propias) como destino.

Acciones Permitidas en la Conciliación de Linkage de Cuentas

🔍 Consulta — Movimientos de Dinero

🔍 Consulta — Transacciones

Descripción: Consulta el Movimiento de Dinero automático de un barrido de linkage, o crea uno manual cuando la conciliación encuentra un balance sin barrer.

Qué esperar después de la acción: Un objeto Movimiento de Dinero con external_id (barridos automáticos) o tu propia referencia (barridos manuales), y un status.

📘 Más información:

🔗 Obtener todos los Movimientos de Dinero

🔗 Obtener un Movimiento de Dinero

🔗 Crear un Movimiento de Dinero

Cómo Empezar

Confirma que el linkage esté configurado para las cuentas que estás conciliando

Consulta Account Linkeage. Los créditos recibidos antes de que se configurara el linkage nunca se barren retroactivamente.

Suscríbete al menos a accounts.balance.credit, enrutado por account_id

Consulta Notificaciones y Suscripciones. Añade los eventos del Movimiento de Dinero automático y del débito secundario si necesitas rastrear la cadena completa en lugar de solo registrar la colección.

Conoce qué campo de correlación aplica en cada pieza

external_id en el Movimiento de Dinero automático, metadata.money_movement_id en ambas Transacciones resultantes — y confirma que ambos estén poblados para tu geografía antes de depender de ellos.

Construye una ruta de barrido manual para los casos de excepción

Los créditos previos al linkage y los movimientos automáticos fallidos requieren ambos mover los fondos manualmente — mediante la API o el Portal.

Qué Esperar Después de Usar esta API

Cada colección de linkage se resuelve en una cadena completamente correlacionada

El crédito original, el Movimiento de Dinero automático, y ambas Transacciones resultantes se vinculan entre sí mediante external_id y metadata.money_movement_id.

La conciliación registra la colección una sola vez

El crédito secundario es el evento de ingreso; el crédito primario es consolidación interna, no una segunda colección.

Las excepciones aparecen como balances secundarios sin barrer

Todo lo que no se barrió automáticamente aparece como un balance en una cuenta secundaria, que resuelves con un Movimiento de Dinero manual.

Conciliación de Linkage de Cuentas

La Cadena de Barrido Automático#

Correlacionar la Cadena para Conciliación#

Tipos de Transacción por Geografía#

Suscripción Mínima Viable de Webhooks#

Cuando el Barrido No Ocurre Automáticamente#

Mover Fondos Manualmente#

Acciones Permitidas en la Conciliación de Linkage de Cuentas#

Cómo Empezar#

Qué Esperar Después de Usar esta API#

La Cadena de Barrido Automático

Correlacionar la Cadena para Conciliación

Tipos de Transacción por Geografía

Suscripción Mínima Viable de Webhooks

Cuando el Barrido No Ocurre Automáticamente

Mover Fondos Manualmente

Acciones Permitidas en la Conciliación de Linkage de Cuentas

Cómo Empezar

Qué Esperar Después de Usar esta API