🇪🇸 Español
- Introducción a Cobre
- Portal
- Developers
- Guías de API
- Explorador de API
- API de Autenticación
- Cuentas
- Crear o Conectar una Cuenta
- Obtener todas las Cuentas
- Obtener una Cuenta
- Actualizar una Cuenta
- Cerrar un Cobre Balance
- Obtener transacciones de una cuenta
- Obtener una transacción de una cuenta
- Obtener todas las Transacciones
- Obtener una transacción
- Obtener Historial de Saldo Diario de Cuenta
- Asignar o cambiar cuenta principal
- Desvinculación de cuenta principal
- Referencias de cuenta
- Verificaciones de Cuenta
- Contrapartes
- Movimientos de Dinero
- Programador de Movimiento de Dinero
- Movimiento de Dinero Masivo
- Aprobaciones de Movimiento de Dinero Masivo
- Llaves Cobre
- Cross Border Payments
- Checkout
- Aprobaciones de Movimientos de Dinero
- API de Evidencia
- Programador de Reportes
- Reports
- Notificaciones y Suscripciones
- Alerts
- Subclients
- Reembolsos
- Kit de desarrollo
- Catálogos de la plataforma
- Diseño de reportes
- APIs de Prueba
- Estructura de Notificaciones
- Schemas
- Authentication
- Counterparties
- Colombia
- PayOut
- Counterparty | Response Metadata Type Cobre Balance (CO)
- Counterparty | Response Metadata Type Breb Key (CO)
- Counterparty | Response Metadata Type QR (CO)
- Counterparty | Response Metadata Type CC (CO)
- Counterparty | Response Metadata Type CH (CO)
- Counterparty | Response Metadata Type DP (CO)
- Counterparty | Create Metadata Type DP (CO)
- Counterparty | Create Metadata Type CH (CO)
- Counterparty | Create Metadata Type CC (CO)
- Counterparty | Create Metadata Type Breb Key (CO)
- Counterparty | Create Metadata Type Cobre Balance (CO)
- Counterparty | Create Metadata Type QR (CO)
- PayIn
- Secondary Counterparty
- Direct Debit
- Counterparty | Create Request (CO)
- Counterparty | Create Response (CO)
- PayOut
- Mexico
- Global
- USA
- Generic
- Counterparty | List All Items
- Colombia
- Transactions
- Global
- Colombia
- Debit
- Credit
- Transaction | Credit Direct Debit (CO) (dd_credit)
- Transaction | Rejected Breb (breb_rejected)
- Transaction | Credit Top Up (CO) (col_top_up_credit)
- 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 | Connect Obtain (CO)
- Transaction | Cobre Balance Obtain (CO)
- Mexico
- Transactions | Connect List All Items
- Transactions | Cobre Balance List All Items
- Transaction | Debit Misc
- Transaction | Credit Misc
- Transaction | Adjustment Debit
- Transaction | Adjustment Credit
- Transaction Metadata | stable_payout_debit
- Transaction Metadata | onramp_credit
- Transaction Metadata | onramp_debit
- Transaction Metadata | offramp_credit
- Transaction Metadata | offramp_debit
- Transaction Metadata | reward_credit
- Transaction Metadata | cbmm_debit (StableFX)
- Transaction Metadata | cbmm_credit (StableFX)
- Transaction | Cobre Balance Obtain (Global/Stable)
- Cobre Keys
- Money Movements
- Approvals
- Mexico
- Colombia
- PayOut
- Money Movement | Create Metadata Type Bre-B
- Money Movement | Response Metadata Type Bre-B
- Money Movement | Response Metadata Type Bre-B Split
- Money Movement | Create Metadata Type Fast Pay
- Money Movement | Create Metadata Type ACH
- Money Movement | Response Metadata Type ACH
- Money Movement | Response Metadata Type Fast Pay
- PayIn
- Money Movement Direct Link | Create Metadata Rail r2p
- 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 r2p
- Money Movement Direct Link | Response Metadata Rail Bancolombia
- Money Movement Direct Link | Response Metadata Rail Nequi
- Direct Debit
- PayOut
- Global
- United States
- Generic
- Money Movement | Create Metadata Type On-Ramp / Off-Ramp
- Money Movement | Response Metadata Type On-Ramp / Off-Ramp
- Money Movement | Response Metadata Type On-Ramp / Off-Ramp
- Money Movement | Create Response
- Money Movement | List All Items
- Accounts
- Cobre Balances and Connect Accounts
- Account Verification
- Mexico
- Colombia
- Account Verification Create Metadata Type col_key_ownership_2
- Account Verification Response Metadata Type col_key_ownership_2
- 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 Verification Response Metadata Type col_key_details_1
- Account Verification Create Response
- Account Verifications List All Items
- Account References
- Daily Balance
- Bulk Money Movement
- Money Movement Scheduler
- Checkout
- Notifications
- Evidence Request
- Cross Border
- Reports
- Error Model
- Report Scheduler
- Alertas
- Subclients
- Refunds
Crear un Movimiento de Dinero
POST
https://api.cobre.co/v1/money_movements
source, destination, metadata y amount. Para un seguimiento mejorado, se puede proporcionar un quinto parámetro opcional, external_id.type: r2p_pse), también se puede enviar un campo opcional subclient_id en el nivel raíz para asociar el movimiento de dinero con un Subcliente creado y aprobado previamente. Este campo es obligatorio para clientes PSP cuando el feature flag correspondiente está habilitado — consulta la guía Gestión de Subclientes - Payins Colombia para el flujo paso a paso.Errores comunes#
subclient_id en el nivel raíz (o anidarlo por error dentro de metadata) en Payins r2p_pse solicitados por clientes PSP que lo requieren — esto devuelve un error MM034.Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************Header Params
Body Params application/json
Examples
Responses
🟢201Created
application/json
Bodyapplication/json
🟠401No autorizado
🟠403Prohibido
🟠409Conflicto
🟠429Demasiadas solicitudes
🔴500Error interno del servidor
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.cobre.co/v1/money_movements' \
--header 'idempotency: 123456789' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"amount": 12300,
"source_id": "acc_V3vkJyasZ2",
"destination_id": "cp_IPOgIyZZbv",
"metadata": {
"description": "PayOut SPEI",
"reference": "1234567"
},
"checker_approval": false,
"external_id": "reference_001"
}'Response Response Example
201 - spei
{
"id": "mm_MhoGJpWavtanVX",
"status": {
"state": "initiated",
"code": "",
"description": ""
},
"metadata": {
"description": "PayOut SPEI",
"reference": "1234567",
"tracking_key": "",
"cep_url": ""
},
"creator": "cli_xxxx",
"external_id": "reference_001",
"checker_approval": false,
"mm_approval_id": "",
"type": "spei",
"geo": "mex",
"source_id": "acc_V3vkJyasZd",
"destination_id": "cp_IPOgIyZZbv",
"currency": "mxn",
"amount": 12300,
"created_at": "2025-12-02T14:19:05Z",
"updated_at": "2025-12-02T14:19:05Z"
}Modified at 2026-10-09 22:39:54