🇪🇸 Español
  • 🇺🇸 English
  • 🇪🇸 Español
  1. Funcionalidades Transversales
🇪🇸 Español
  • 🇺🇸 English
  • 🇪🇸 Español
  • Introducción a Cobre
    • Bienvenido
    • Comenzar
    • Productos
      • Local Payments
        • Local Payments con Cobre
        • Payins
          • Colombia
            • Checkout
            • Request to Pay (R2P)
            • Débito directo con Nequi
            • Llaves Bre-B estáticas
          • México
            • Referencia de cuenta – CLABEs virtuales
            • Cobre Balance respaldados por CLABE
        • Payouts
          • Colombia
            • Movimientos de dinero con Bre-B
            • Movimientos de dinero con Cobre Fast Pay
          • Mexico
            • Movimientos de dinero con CLABEs y tarjetas SPEI
          • Multi-region
            • Programador de movimientos de dinero
        • Otras funcionalidades
          • Movimientos de dinero masivos
          • Habilitación de flujos de aprobación (Creador–Verificador)
      • CrossBorder Payments
        • Cross Border Payments con Cobre
      • Connect
        • Conectar cuentas bancarias con Cobre
      • Stablecoins
        • PayOuts globales en stablecoins
    • Otras funcionalidades
      • Verificación de cuentas
      • Notificaciones y suscripciones
      • Seguridad en Cobre
      • Rendimiento y throughput
  • Portal
    • Introducción e Inicio Rápido
    • Autenticación en Portal
    • Solución de Problemas y Soporte
    • Movements
      • Proceso de Aprobación (Maker-Checker)
      • Movimiento de Dinero Local
      • Iniciación de Pago Unitario
      • Iniciación de Movimiento de Dinero Masivo
      • Movimientos de Dinero Transfronterizos
      • Enlaces de Pago
      • Scheduler
    • Transactions
      • Transactions
    • Accounts
      • Gestión de Cuentas y Saldos
      • CLABEs Virtuales
    • Counterparties
      • Counterparties
    • Reports
      • Reportes y Conciliación
    • Settings
      • Gestión de Usuarios y Roles
      • Seguridad y Control
    • Developers
      • Gestión de suscripciones
  • Developers
    • Guías de API
      • Inicio rápido
      • Autenticación
      • Cobre Balance
        • Gestión de Virtual Balance Accounts (Cobre Balances)
        • Vinculación de Cuentas
      • Cuentas Connect
        • Gestión de Cuentas Connect
      • Counterparties
        • Gestión de Contrapartes
      • Local Payments
        • Movimiento de Dinero
        • Payouts
          • Colombia
            • Fast Pay & ACH
            • Bre-B
          • Mexico
            • SPEI
          • Cross-Region
            • Movimientos Masivos de Dinero
            • Aprobación de Movimientos Masivos de Dinero
            • Programador de Movimientos de Dinero
        • Payins
          • Colombia
            • Checkout
            • Débito Directo
            • Llaves Cobre con Bre-B
            • Direct Link
          • Mexico
            • Referencia de Cuenta – CLABEs Virtuales
      • Pagos Transfronterizos
        • Pagos Transfronterizos
        • Fondea tu Cobre Balance global
        • Crear Cotizaciones Fx
        • Crear un Movimiento de Dinero Transfronterizo
      • Funcionalidades Transversales
        • Verificación de Cuentas
        • Conciliación con Reportes Cobre en Colombia
        • Reports
        • Programador de Reportes
        • API de Evidencia
        • Notificaciones y Suscripciones
      • Manejo de Errores
        • Diccionario de Errores
      • Testing
        • Pruebas generales
        • Casos de prueba
        • Pruebas de PSE y Bancolombia
    • Explorador de API
      • API de Autenticación
        • Authentication
      • Cobre Balance
        • Crear un Cobre Balance
        • Obtener todas las Cuentas
        • Obtener una Cuenta
        • Actualizar una Cuenta
        • Cerrar un Cobre Balance
        • Obtener transacciones de una cuenta
        • Obtener una Transacción
        • Obtener todas las Transacciones del Cliente
        • Obtener Historial de Saldo Diario de Cuenta
        • Asignar o cambiar cuenta principal
        • Desvinculación de cuenta principal
      • Cuentas Connect
        • Conectar una Cuenta
        • Obtener una Cuenta Conectada
        • Obtener todas las Cuentas Conectadas
        • Obtener una Transacción
        • Obtener Todas las Transacciones de la Cuenta
        • Obtener todas las Transacciones del Cliente
        • Actualizar una cuenta
      • Verificaciones de Cuenta
        • Obtener una Verificación de Cuenta
        • Crear una Verificación de Cuenta
        • Obtener todas las Verificaciones de Cuenta
      • Referencias de cuenta
        • Crear una referencia de cuenta
        • Listar una Referencia de Cuenta
        • Listar todas las Referencias de Cuenta
        • Eliminar una Referencia de Cuenta
      • Llaves Cobre
        • Crear una Llave
        • Obtener todas las Llaves
        • Obtener una Llave
        • Cancelar una llaves
        • Bloquear o reactivar claves
      • Contrapartes
        • Registro de Débito de Cuenta
          • Registrar una Contraparte para Débito Directo
          • Obtener todos los Registros
          • Obtener un Registro
        • Crear una Contraparte
        • Obtener una contraparte
        • Obtener todas las contrapartes
        • Eliminar una contraparte
      • Movimientos de Dinero
        • Crear un Movimiento de Dinero
        • Obtener un Movimiento de Dinero
        • Obtener todos los Movimientos de Dinero
        • Devolver un Movimiento de Dinero
      • Aprobaciones de Movimientos de Dinero
        • Aprobar un Movimiento de Dinero
        • Listar todas las Aprobaciones de Movimientos de Dinero
      • Programador de Movimiento de Dinero
        • Crear un Programador de Movimiento de Dinero
        • Listar todos los Programadores de Movimiento de Dinero
        • Cancelar un Programador Activo
      • Movimiento de Dinero Masivo
        • Crear un Movimiento de Dinero Masivo
        • Listar todos los Movimientos de Dinero Masivos
        • Listar un Movimiento de Dinero Masivo
      • Aprobaciones de Movimiento de Dinero Masivo
        • Decisión de Movimientos de Dinero Masivos
      • CrossBorder Payments
        • Crear una Cotización FX
        • Obtener una Cotización FX
        • Obtener todas las Cotizaciones FX
        • Crear un Movimiento de Dinero Cross Border
        • Obtener un Movimiento de Dinero Transfronterizo
        • Obtener todos los Movimientos de Dinero Transfronterizos
      • Checkout
        • Crear un Checkout
        • Obtener un Checkout
        • Obtener todos los Checkouts
        • Desactivar un Checkout
      • API de Evidencia
        • Solicitudes de Evidencia
          • Obtener Solicitud de Evidencia
          • Buscar Solicitudes de Evidencia
        • Documentos de Evidencia
          • Generar Enlaces de Carga
          • Generar Enlace de Descarga
        • Información de Evidencia
          • Enviar Información de Evidencia
      • Reports
        • Crear un Reporte
        • Obtener todos los Reportes
        • Generar Enlace de Descarga para Reportes Seleccionados
        • Crear un Estado de Cuenta de Cobre Balance
      • Programador de Reportes
        • Crear un Programador de Reportes
        • Obtener todos los Programadores de Reportes
        • Eliminar un Programador de Reportes
      • Notificaciones y Suscripciones
        • Suscribirse a Eventos
        • Obtener todas las Suscripciones
        • Eliminar una Suscripción
        • Listar todos los Eventos Disponibles
    • Catálogos de la plataforma
      • Códigos bancarios mexicanos
      • Códigos bancarios colombianos
      • Tipos de transacción
      • Proveedores de cuenta
    • Diseño de reportes
      • Diseño de movimientos de dinero
        • Todos los movimientos de dinero (CSV)
        • Todos los movimientos de dinero (JSON)
        • Movimientos de dinero SPEI (CSV)
        • Movimientos de dinero LEGACY (CSV)
      • Diseño de transacciones
        • Todas las transacciones (CSV)
        • Todas las transacciones (JSON)
        • Estado de cuenta de Virtual Balance Account (Cobre Balance) (PDF)
      • Diseño de contrapartes
        • Todas las contrapartes (CSV)
      • Diseño de Multicash
        • Encabezado de Multicash (TXT)
        • Multicash Detail (TXT)
    • APIs de Prueba
      • Crear un ajuste de transacción
      • Cambiar el estado de un movimiento de dinero
      • Ajuste de Transacción (QA)
      • Cambiar Estado de Movimiento de Dinero (QA)
    • Estructura de Notificaciones
      • Eventos de Cuenta
        • Crédito de Cuenta
        • Débito de Cuenta
      • Cobre Keys
        • Cobre Keys
      • Movimiento de Dinero
        • Movimiento de Dinero
      • Movimiento de Dinero Masivo
        • Movimiento de Dinero Masivo
      • Movimiento de Dinero Transfronterizo
        • Movimiento de Dinero Transfronterizo
      • Solicitudes de Evidencia
        • Solicitudes de Evidencia
      • Reports
        • Reports
  • Schemas
    • Counterparties
      • USA
        • Counterparty | Create Request (USA)
        • Counterparty | Create Response (USA)
        • Request Medatata Business
        • Response Medatata Business
        • Request Medatata Individual
        • Response Medatata Individual
      • RequestBodies
        • Counterparty-request
      • Colombia
        • PayOut
          • Counterparty | Create Metadata Type CC (CO)
          • Counterparty | Create Metadata Type CH (CO)
          • Counterparty | Create Metadata Type DP (CO)
          • Counterparty | Create Metadata Type Breb Key (CO)
          • Counterparty | Create Metadata Type Cobre Balance (CO)
          • Counterparty | Response Metadata Type CC (CO)
          • Counterparty | Response Metadata Type CH (CO)
          • Counterparty | Response Metadata Type DP (CO)
          • Counterparty | Response Metadata Type Breb Key (CO)
          • Counterparty | Response Metadata Type Cobre Balance (CO)
        • PayIn
          • Counterparty | Create Metadata Type r2p (CO)
          • Counterparty | Create Metadata Type r2p Breb (CO)
          • Counterparty | Response Metadata Type r2p (CO)
          • Counterparty | Response Metadata Type r2p Breb (CO)
        • Secondary Counterparty
          • Secondary Counterparty Create Response (CO)
          • Secondary Counterparty Create Request (CO)
          • Secondary Counterparty Create Metadata Type NP (CO)
          • Secondary Counterparty Request Metadata Type LE
          • Secondary Counterparty Response Metadata Type NP (CO)
          • Secondary Counterparty Response Metadata Type LE (CO)
        • Direct Debit
          • Direct Debit Registration | Create
          • Direct Debit Registration | Response
          • Direct Debit Registration | List All Items
        • Counterparty | Create Response (CO)
        • Counterparty | Create Request (CO)
      • Mexico
        • PayOut
          • Counterparty | Create Metadata Type Clabe (MX)
          • Counterparty | Create Metadata Type SPEI Card (MX)
          • Counterparty | Response Metadata Type Clabe (MX)
          • Counterparty | Response Metadata Type SPEI Card (MX)
        • Counterparty | Create Response (MX)
        • Counterparty | Create Request (MX)
      • Counterparty | List All Items
      • MEX Money Movement Return
    • Transactions
      • Global
        • Transaction | Credit Cross Border
        • Transaction | Debit Cross Border
      • Colombia
        • Debit
          • Transaction | Debit FI (CO) (col_debit)
          • Transaction | Debit Cobre Balance (CO)
          • Transaction | Debit Breb (CO) (breb_debit)
        • Credit
          • Transaction | Credit Direct Debit (CO) (dd_credit)
          • Transaction | Rejected Breb (breb_rejected)
          • Transaction | Credit FI (CO) (col_credit)
          • Transaction | Credit Cobre Balance (CO) (col_cb_credit)
          • Transaction | Credit r2p (r2p_credit)
          • Transaction | Credit Breb (CO) (breb_credit)
          • Transaction | Credit r2p Breb (CO) (r2p_breb_credit)
          • Transaction | Credit Top Up (CO) (col_top_up_credit)
        • Transaction | Connect Obtain (CO)
        • Transaction | Cobre Balance Obtain (CO)
      • Mexico
        • Debit
          • Transaction | Debit SPEI (MX) (spei_debit)
          • Transaction | Debit FI (MX) (mex_debit)
          • Transaction | Debit Internal SPEI (MX)
        • Credit
          • Transaction | Credit SPEI (MX)
          • Transaction | Credit FI (MX)
          • Transaction | Credit Internal SPEI (MX)
        • Transaction | Connect Obtain (MX)
        • Transaction | Cobre Balance Obtain (MX)
        • Transaction | Return SPEI (MX)
      • Transactions | Connect List All Items
      • Transactions | Cobre Balance List All Items
      • Transaction | Adjustment Credit
      • Transaction | Adjustment Debit
      • Transaction | Credit Misc
      • Transaction | Debit Misc
    • Authentication
      • Authentication | Request
      • Authentication | Response
    • Cobre Keys
      • Colombia
        • Cobre Key | Create Request
        • Cobre Key | Create Response
        • Cobre Key | Obtain Response
        • Cobre Key | Reactive Request
    • Money Movements
      • Approvals
        • Money Movement Approvals | Create Request
        • Money Movement Approvals | Create Response
        • Money Movement Approvals | List All Items
      • Mexico
        • PayOut
          • Money Movement | Create Metadata Type SPEI
          • Money Movement | Response Metadata Type SPEI
        • Return
          • Money Movement Return | Create Request
          • Money Movement Return | Create Response
          • Money Movement Return | Response Medatada Type SPEI
      • Colombia
        • PayOut
          • Money Movement | Create Metadata Type Fast Pay
          • Money Movement | Create Metadata Type ACH
          • Money Movement | Create Metadata Type Breb
          • Money Movement | Response Metadata Type ACH
          • Money Movement | Response Metadata Type Fast Pay
          • Money Movement | Response Metadata Type ACH
        • PayIn
          • Money Movement Direct Link | Create Metadata Rail PSE
          • Money Movement Direct Link | Create Metadata Rail r2p Breb
          • Money Movement Direct Link | Response Metadata Rail r2p Breb
          • Money Movement Direct Link | Response Metadata Rail PSE
          • Money Movement Direct Link | Response Metadata Rail Bancolombia
          • Money Movement Direct Link | Response Metadata Rail Nequi
        • Direct Debit
          • Money Movement Direct Debit | Create Metadata
          • Money Movement Direct Debit | Response Metadata
      • Money Movement | Create Response
      • Money Movement | List All Items
    • Accounts
      • Account Verification
        • Mexico
          • Account Verification Create Metadata Type mex_acc_details_1
          • Account Verification Response Metadata Type mex_acc_details_1
          • Account Verification Create Request
          • Account Verification Create Response
          • Account Verifications List All Items
          • Account Verification Create Metadata Type mex_acc_ownership_1
          • Account Verification Response Metadata Type mex_acc_ownership_1
        • Colombia
          • Account Verification Response Metadata Type col_key_details_1
          • Account Verification Create Metadata Type col_key_details_1
          • Account Verification Create Metadata Type col_key_ownership_1
          • Account Verification Response Metadata Type col_key_ownership_1
      • Account References
        • Account References Request
        • Account Reference Response
        • List all account references
      • Cobre Balances
        • Mexico
          • Cobre Balance | Create Metadata (MX)
          • Cobre Balance | Create Response (MX)
        • Colombia
          • Cobre Balance | Create Response (CO)
          • Cobre Balance | Create Metadata (CO)
        • Global
          • Cobre Balance | Create Response (Global)
          • Cobre Balance | Create Metadata (Global)
        • Cobre Balance | Create Request
        • Cobre Balances | List All Items
        • Account_request_PATCH
        • Account_request_CONNECT_PATCH
      • Daily Balance
        • Daily Balance Historiy List All Items
        • Daily Balance Obtain Response
      • Account Connect
        • Mexico
          • Account Connect | Response Metadata (MX)
          • Account Conect | Create Metadata (MX)
        • Colombia
          • Account Connect | Response Metadata (CO)
          • Account Conect | Create Metadata (CO)
        • Account Connect | Create Request
        • Accounts Connect | List All Items
    • Bulk Money Movement
      • Bulk Money Movement | Obtain Response
      • Bulk Money Movement Decision | Create Request
      • Bulk Money Movements | List All Items
    • Money Movement Scheduler
      • Money Movement Scheduler | Create Request
      • Money Movement Scheduler | Create Response
      • Money Movement Scheduler | List All Items
    • Checkout
      • Colombia
        • Checkout | Create Request
        • Checkout | Create Response
        • Checkout | List All Items
        • Checkout | Delete
    • Notifications
      • Subscription | Create Request
      • Subscription | Create Response
      • Subscription | List All Items
      • Subscribable Events | List All Items
      • Subscribable Events | Metadata
    • Evidence Request
      • Schemas
        • Error
        • Evidence Request
        • Document Type
        • Evidence Id
        • Upload Intent
        • Evidence Request Id
        • Evidence Request Status
        • Information Type
        • Information
        • Evidence
        • Information Status
        • Document
        • Document Status
        • Headers
      • RequestBodies
        • UploadIntentRequest
    • Cross Border
      • Cross Border Money Movement
        • Cross Border Money Movement Create Request
        • Cross Border Money Movement Obtain Response
        • Cross Border Money Movements List All Items
        • Cross Border Money Movement Create Response
      • FX Quote
        • FX Static Quote
          • FX Quote Static | Create Response
          • FX Quote Static | Create Request
        • FX Rolling Quote
          • FX Quote Rolling | Create Response
          • FX Quote Rolling | Create Request
        • FX Quote | Create Request
        • FX Quote | List All Items
        • FX Quote | Metadata Fees Breakdown
        • FX Quote | Metadata Quote Tiers
        • FX Quote | Metadata Penalization Tier
    • Reports
      • Download
        • Report Download Create Request
        • Report Download Create Response
      • Reports Create Request
      • Reports Create Response
      • Request Body Reports
      • Reports List All Items
      • Reports Object
      • Reportes Create Metadata
    • Error Model
      • Error-model
    • Report Scheduler
      • Report Schedulers | Create Request
      • Report Schedulers | Create Response
  1. Funcionalidades Transversales

Conciliación con Reportes Cobre en Colombia

Resumen general#

Esta guía explica cómo conciliar correctamente transacciones de PayOut (desembolsos) y PayIn (cobranzas) en la plataforma de Cobre para pagos locales en Colombia. Comprender la relación entre Money Movements, Transactions y tus registros internos es esencial para una conciliación financiera precisa.

Conceptos clave#

Money Movement vs Transaction#

En la plataforma de Cobre, cada operación de pago involucra dos identificadores clave:
IdentificadorDescripciónEjemploCuándo se genera
Money Movement IDIdentificador único de la solicitud/operación de pagomm_ady1n4g4udCuando se crea el money movement
Transaction IDIdentificador único del asiento en el libro contabletrx_sjrirldkmkCuando los fondos se debitan o acreditan a tu Cobre Balance
Relación clave:
Un Money Movement puede generar una o más Transactions
Cada Transaction está vinculada a un Money Movement
Los Money Movements representan la intención; las Transactions representan los cambios reales de saldo

Métodos de identificación#

Al crear cualquier money movement (PayOut o PayIn), tienes dos formas de identificarlo y rastrearlo:

1. Money Movement ID (generado por Cobre)#

Generado por: la plataforma de Cobre automáticamente
Formato: prefijo mm_ seguido de una cadena alfanumérica
Unicidad: globalmente único en todas las operaciones de Cobre
Disponibilidad: siempre presente en la respuesta del API cuando se crea el money movement
Caso de uso: identificador principal para el seguimiento con Cobre

2. External ID (provisto por el cliente)#

Generado por: tu sistema (provisto en la solicitud del API)
Formato: cualquier formato de cadena que definas (hasta 255 caracteres)
Unicidad: debe ser único dentro de tu organización
Disponibilidad: campo opcional en la solicitud; se devuelve en las respuestas
Caso de uso: vincular operaciones de Cobre con tus registros internos (facturas, órdenes, etc.)
Ejemplo de solicitud:
curl --request POST \
  --url https://api.cobre.co/v1/money_movements \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'idempotency: ' \
  --data '{
  "source_id": "acc_1232145215",
  "destination_id": "cp_5YFeIDhNkz",
  "amount": 1000,
  "external_id": "clientUser1234",
  "metadata": {
    // Will change according to the money movement type
  },
  "checker_approval": false
}'
Ejemplo de respuesta:
{
  "id": "mm_0987654321",
  "batch_id": "bat_0987654321" || "chk_0987654321",
  "external_id": "clientUser1234",
  "mm_approval_id": "",
  "creator": "usr_bGcdf26rR4",
  "type": "fast_pay",
  "geo": "col",
  "status": {
    "state": "initiated",
    "code": "string",
    "description": "string"
  },
  "source_id": "acc_KJnAkypWSc",
  "source": {},
  "destination_id": "cp_5YFeIDhNkz",
  "destination": {},
  "currency": "cop",
  "amount": 100,
  "metadata": {
    // Will change according to the money movement type
  },
  "created_at": "2026-06-24T15:37:37Z",
  "updated_at": "2026-06-24T15:37:38Z",
  "checker_approval": false
}

Conciliación de PayOut#

Los PayOuts (desembolsos) te permiten enviar dinero desde tu Cobre Balance a cuentas bancarias externas o counterparties.

Estructura de la solicitud de PayOut#

Al crear un PayOut, especificas:
CampoDescripciónRequerido
source_idTu Cobre Balance (cuenta de origen)✅ Sí
destination_idCuenta del beneficiario/counterparty✅ Sí
amountMonto a desembolsar (en unidades menores, p. ej., centavos)✅ Sí
external_idTu referencia única para seguimientoNo, pero recomendado

Flujo de Transactions de PayOut#

Flujo esperado: desembolso exitoso#

┌─────────────────────────────────────┐
│  1. Create PayOut Money Movement    │
│  POST /v1/money_movements           │
│  • Amount: 10,000 COP               │
│  • External ID: INV-2025-001        │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  2. Money Movement Created          │
│  • MM ID: mm_ady1n4g4ud             │
│  • Status: processing               │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  3. Debit Transaction Created       │
│  • TRX ID: trx_sjrirldkmk           │
│  • Type: debit                      │
│  • Amount: -10,000 COP              │
│  • Account: Source Balance          │
│  • Instant application              │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  4. Funds Sent Successfully         │
│  • MM Status: completed             │
│  • Destination received funds       │
└─────────────────────────────────────┘
Pasos de conciliación:
1.
Money Movement creado:
Money Movement ID: mm_ady1n4g4ud
External ID: INV-2025-001
Monto: 10,000 COP
Estado: processing
2.
Transaction de débito aplicada (inmediata):
Transaction ID: trx_sjrirldkmk
Tipo: debit
Monto: -10,000 COP
Saldo de la cuenta: se reduce en 10,000 COP de inmediato
Vinculada al Money Movement: mm_ady1n4g4ud
3.
Estado final:
Estado del Money Movement: completed
Tu Cobre Balance: se reduce permanentemente en 10,000 COP
Beneficiario: recibió 10,000 COP
Registro de conciliación:
Money Movement IDExternal IDTipoMontoTransactionsImpacto final en saldo
mm_ady1n4g4udINV-2025-001PayOut10,000 COP1 débito (trx_sjrirldkmk)-10,000 COP

Flujo alternativo: desembolso rechazado#

┌─────────────────────────────────────┐
│  1. Create PayOut Money Movement    │
│  POST /v1/money_movements           │
│  • Amount: 10,000 COP               │
│  • External ID: INV-2025-002        │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  2. Money Movement Created          │
│  • MM ID: mm_xyz789def              │
│  • Status: processing               │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  3. Debit Transaction Created       │
│  • TRX ID: trx_abc123first          │
│  • Type: debit                      │
│  • Amount: -10,000 COP              │
│  • Account: Source Balance          │
│  • Instant application              │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  4. Destination Rejects Payment     │
│  • MM Status: rejected              │
│  • Reason: Invalid account, etc.    │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  5. Credit Transaction Created      │
│  • TRX ID: trx_abc123second         │
│  • Type: credit (reversal)          │
│  • Amount: +10,000 COP              │
│  • Account: Source Balance          │
│  • Funds returned to origin         │
└─────────────────────────────────────┘
Pasos de conciliación:
1.
Money Movement creado:
Money Movement ID: mm_xyz789def
External ID: INV-2025-002
Monto: 10,000 COP
Estado: processing
2.
Transaction de débito aplicada (inmediata):
Transaction ID: trx_abc123first
Tipo: debit
Monto: -10,000 COP
Saldo de la cuenta: se reduce en 10,000 COP de inmediato
3.
Ocurre el rechazo:
Estado del Money Movement: rejected
Motivo: la cuenta de destino rechazó el pago o es inválida
4.
Transaction de crédito aplicada (reverso):
Transaction ID: trx_abc123second
Tipo: credit
Monto: +10,000 COP
Saldo de la cuenta: se restaura en 10,000 COP
Vinculada al mismo Money Movement: mm_xyz789def
5.
Estado final:
Estado del Money Movement: rejected
Tu Cobre Balance: cambio neto = 0 COP (débito + crédito)
Beneficiario: no recibió fondos
Registro de conciliación:
Money Movement IDExternal IDTipoMontoTransactionsImpacto final en saldo
mm_xyz789defINV-2025-002PayOut10,000 COP2 transactions:
1. Débito: trx_abc123first (-10,000)
2. Crédito: trx_abc123second (+10,000)
0 COP (revertido)

Buenas prácticas de conciliación de PayOut#

✅ Rastrea ambos IDs: guarda money_movement_id y external_id en tus registros
✅ Monitorea cambios de estado: un PayOut con 2 transactions (débito + crédito) indica un rechazo
✅ Usa webhooks: suscríbete a eventos de cambio de estado para actualizar registros en tiempo real
✅ Consulta el Transaction Report: descarga reportes filtrados por rango de fechas para conciliar todos los movimientos
✅ Verificación de saldo neto: para PayOuts rechazados, verifica que las transactions de débito y crédito se compensen

Conciliación de PayIn#

Los PayIns (cobranzas) te permiten recibir dinero en tu Cobre Balance desde pagadores. Cobre ofrece dos métodos de PayIn:
1.
Direct Link — Generar un link de pago para un pagador específico
2.
CheckOut — Crear una página de pago flexible con múltiples opciones

Estructura de la solicitud de PayIn#

Al crear un PayIn, especificas:
CampoDescripciónRequerido
counterparty_idInformación del pagador✅ Sí
destination_idTu Cobre Balance (a donde llegan los fondos)✅ Sí
amountMonto a cobrar✅ Sí (o monto abierto para CheckOut)
external_idTu referencia única para seguimientoNo, pero recomendado
payment_methodsMétodos de pago permitidos✅ Sí

Flujo de Transactions de PayIn#

Flujo esperado: cobranza exitosa (Direct Link)#

┌─────────────────────────────────────┐
│  1. Create Direct Link              │
│  POST /v1/money_movements           │
│  • Amount: 10,000 COP               │
│  • External ID: ORDER-2025-050      │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  2. Direct Link Created             │
│  • MM ID: mm_payin123abc            │
│  • Payment link URL generated       │
│  • Status: processing               │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  3. Payer Opens Link                │
│  • Chooses payment method           │
│  • Completes payment                │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  4. Payment Confirmed               │
│  • MM Status: completed             │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  5. Credit Transaction Created      │
│  • TRX ID: trx_credit999xyz         │
│  • Type: credit                     │
│  • Amount: +10,000 COP              │
│  • Account: Destination Balance     │
└─────────────────────────────────────┘
Pasos de conciliación:
1.
Direct Link creado:
Money Movement ID: mm_payin123abc
External ID: ORDER-2025-050
Monto: 10,000 COP
Estado: pending
URL de pago: compartida con el pagador
2.
El pagador completa el pago:
El pagador usa el link para pagar
El método de pago se procesa exitosamente
3.
Estado del Money Movement actualizado:
El estado cambia a: completed
4.
Transaction de crédito creada (solo después de completarse):
Transaction ID: trx_credit999xyz
Tipo: credit
Monto: +10,000 COP
Saldo de la cuenta: aumenta en 10,000 COP
Vinculada al Money Movement: mm_payin123abc
5.
Estado final:
Estado del Money Movement: completed
Tu Cobre Balance: aumenta en 10,000 COP
Pagador: pagó exitosamente
Registro de conciliación:
Money Movement IDExternal IDTipoMontoTransactionsImpacto final en saldo
mm_payin123abcORDER-2025-050PayIn (Direct Link)10,000 COP1 crédito (trx_credit999xyz)+10,000 COP

Flujo esperado: cobranza exitosa (CheckOut)#

┌─────────────────────────────────────┐
│  1. Create CheckOut                 │
│  POST /v1/checkouts                 │
│  • Amount: 10,000 COP (or open)     │
│  • External ID: INV-2025-150        │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  2. CheckOut Created                │
│  • CheckOut ID: chk_809821845       │
│  • Payment page URL generated       │
│  • Status: pending                  │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  3. Payer Opens CheckOut            │
│  • Chooses payment method           │
│  • Enters amount (if open)          │
│  • Completes payment                │
│   MM ID: mm_checkout456def          │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  4. Payment Confirmed               │
│  • MM Status: completed             │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  5. Credit Transaction Created      │
│  • TRX ID: trx_checkout888ghi       │
│  • Type: credit                     │
│  • Amount: +10,000 COP              │
│  • Account: Destination Balance     │
└─────────────────────────────────────┘
Pasos de conciliación: (igual que Direct Link)
El flujo es idéntico a Direct Link, con el mismo patrón de creación de transactions:
La transaction de crédito solo se crea cuando status = completed
Si el pago falla o es rechazado, no se crea ninguna transaction
Registro de conciliación:
Money Movement IDExternal IDTipoMontoTransactionsImpacto final en saldo
mm_checkout456defINV-2025-150PayIn (CheckOut)10,000 COP1 crédito (trx_checkout888ghi)+10,000 COP

Flujo alternativo: cobranza fallida#

┌─────────────────────────────────────┐
│  1. Create Direct Link/CheckOut     │
│  • Amount: 10,000 COP               │
│  • External ID: ORDER-2025-999      │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  2. Money Movement Created          │
│  • MM ID: mm_failed777ghi           │
│  • Status: processing               │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  3. Payer Attempts Payment          │
│  • Payment method fails             │
│  • Insufficient funds, etc.         │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│  4. Payment Rejected                │
│  • MM Status: rejected              │
│  • NO transaction created           │
└─────────────────────────────────────┘
Pasos de conciliación:
1.
Money Movement creado:
Money Movement ID: mm_failed777ghi
External ID: ORDER-2025-999
Monto: 10,000 COP
Estado: pending
2.
El pago falla:
El método de pago del pagador fue declinado
El estado cambia a: rejected
3.
No se crea ninguna Transaction:
Importante: no se genera transaction de crédito
Tu Cobre Balance permanece sin cambios
4.
Estado final:
Estado del Money Movement: rejected
Tu Cobre Balance: sin cambio (impacto 0 COP)
Pagador: no pagó exitosamente
Registro de conciliación:
Money Movement IDExternal IDTipoMontoTransactionsImpacto final en saldo
mm_failed777ghiORDER-2025-999PayIn10,000 COP0 transactions0 COP (no se recibieron fondos)

Buenas prácticas de conciliación de PayIn#

✅ Crédito solo al completarse: las transactions SOLO se crean cuando status = completed
✅ Rastrea pagos pendientes: monitorea money movements en estado processing para la acción del pagador
✅ Gestiona rechazos: los money movements con estado rejected tendrán 0 transactions
✅ Usa external_id: vincula a tus órdenes, facturas o registros de clientes
✅ Integración con webhooks: recibe notificaciones cuando los pagadores completen pagos
✅ Conciliación por transaction: usa el Transaction Report para verificar que todos los créditos coincidan con money movements completados

Transaction Reports#

Cobre proporciona Transaction Reports para facilitar la conciliación en todos tus money movements.

Estructura del reporte#

Los siguientes campos en el layout del reporte ayudarán a realizar el proceso de conciliación:
CampoDescripciónEjemplo
idIdentificador único de la transactiontrx_sjrirldkmk
metadata.money_movement_idMoney movement vinculadomm_ady1n4g4ud
typeTipo de operacióncol_debit, col_credit, r2p_credit
credit_debit_typeDébito o créditodebit, credit
amountMonto de la transaction10000 (en unidades menores)
currencyCódigo de monedaCOP
account_idTu Cobre Balance afectadoacc_123abc
metadata.mm_external_idTu referenciaINV-2025-001
created_atTimestamp de la transaction2024-06-24T15:37:38Z

Consulta de Transaction Reports#

Endpoint del API:
GET /v1/reports
Ejemplo de solicitud
Ejemplo de respuesta:
{
  "id": "repo_kJs8GO03vC",
  "resource": "string",
  "start_date": "2024-09-28T00:00:00Z",
  "end_date": "2024-10-05T00:00:00Z",
  "offset": "-05:00",
  "requested_at": "2024-10-28T12:39:11Z",
  "created_at": "2024-10-28T12:39:11Z",
  "metadata": {
    "account_id": "acc_123456",
    "statement_date": "2025-05"
  },
  "file_name":"20240928_20241028_transactions_repo_kjs8go03vc.csv",
 "file_format": "csv",
 "file_layout": "transactions_csv_v1",
  "sensitive_data": false
}

Flujo de trabajo de conciliación#

Proceso paso a paso#

1. Descargar Transaction Report#

2. Agrupar por Money Movement ID#

Organiza las transactions por su money movement vinculado:
Money Movement: mm_ady1n4g4ud
├─ Transaction 1: trx_sjrirldkmk (debit: -10,000 COP)
   
Money Movement: mm_xyz789def  
├─ Transaction 1: trx_abc123first (debit: -10,000 COP)
├─ Transaction 2: trx_abc123second (credit: +10,000 COP)

3. Hacer match de External IDs#

Cruza external_id con tus sistemas internos:
Cobre External ID: INV-2025-001
→ Coincide con factura interna: INV-2025-001
→ Money Movement: mm_ady1n4g4ud
→ Impacto neto: -10,000 COP

4. Verificar el impacto neto en saldo#

Para PayOuts:
Completed: 1 transaction de débito (impacto neto: negativo)
Rejected: 1 transaction de débito + 1 transaction de crédito (impacto neto: cero)
Para PayIns:
Completed: 1 transaction de crédito (impacto neto: positivo)
Rejected: 0 transactions (impacto neto: cero)

Fórmulas de conciliación#

Cálculo esperado de saldo#

Saldo actual = Saldo anterior + Créditos - Débitos
Ejemplo:

Saldo anterior: 100,000 COP
Créditos (PayIns): +50,000 COP
Débitos (PayOuts): -30,000 COP
Saldo actual: 100,000 + 50,000 - 30,000 = 120,000 COP

Cantidad de transactions por Money Movement#

PayOut:
Completed: 1 transaction (débito)
Rejected: 2 transactions (débito + reverso en crédito)
PayIn:
Completed: 1 transaction (crédito)
Rejected: 0 transactions

Escenarios comunes de conciliación#

Escenario 1: Todos los PayOuts exitosos#


Money Movements: 5 PayOuts
Transactions esperadas: 5 débitos
Impacto neto: -50,000 COP (suma de todos los PayOuts)

Escenario 2: PayOut con rechazo#


Money Movement: mm_rejected001
Transaction 1: -10,000 COP (debit)
Transaction 2: +10,000 COP (credit)
Impacto neto: 0 COP
Estado: rejected

Escenario 3: PayIn completado#


Money Movement: mm_payin001
Transaction 1: +25,000 COP (credit)
Impacto neto: +25,000 COP
Estado: completed

Escenario 4: PayIn pendiente (sin pago aún)#


Money Movement: mm_pending001
Transactions: 0
Impacto neto: 0 COP
Estado: pending
Acción: Esperar a que el pagador complete el pago

Solución de problemas#

Problema 1: Falta External ID en el reporte#

Problema: la transaction muestra external_id en null
Causa: no se proporcionó external_id al crear el money movement
Solución: incluye siempre external_id en tus solicitudes al API

Problema 2: Diferencia de saldo#

Problema: el saldo calculado no coincide con el saldo real
Causa: faltan transactions o reversos no reportados
Solución:
1.
Consulta el historial completo de transactions del periodo
2.
Revisa money movements rechazados (2 transactions cada uno)
3.
Verifica los estados de todos los money movements

Problema 3: Conciliación duplicada#

Problema: la misma transaction se concilia dos veces
Causa: uso de external_id no único
Solución: asegúrate de que external_id sea único por money movement

Problema 4: PayIn sin transaction#

Problema: PayIn completado no tiene transaction de crédito
Causa: el estado del money movement no es completed
Solución: revisa el estado del money movement; las transactions solo se crean cuando está en completed

Referencia de endpoints del API#

Crear PayOut#


POST /v1/money_movements

Crear Direct Link (PayIn)#


POST /v1/money_movements

Crear CheckOut (PayIn)#


POST /v1/checkouts

Obtener estado de Money Movement#


GET /v1/money_movements/{money_movement_id}

Obtener detalle de Transaction#


GET /v1/transactions/{transaction_id}

Descargar Transaction Report#


GET /v1/reports

Puntos clave#

✅ Cada money movement tiene un ID único — usa money_movement_id como identificador principal
✅ Los external_id son críticos — proporciona siempre external_id para la conciliación
✅ El timing de transactions difiere — PayOuts crean débitos inmediatos; PayIns crean créditos solo al completarse
✅ Los rechazos crean reversos — rechazos de PayOut generan 2 transactions (débito + crédito)
✅ Usa Transaction Reports — descarga reportes por rango de fechas para conciliación masiva
✅ Monitorea cambios de estado — suscríbete a webhooks para actualizaciones en tiempo real
✅ Fórmula de saldo neto — PayOuts completed = -monto, PayIns completed = +monto, rechazos = 0

Modified at 2026-02-13 23:29:47
Previous
Verificación de Cuentas
Next
Reports
Built with