🇪🇸 Español
  • 🇺🇸 English
  • 🇪🇸 Español
  1. Cobre Balance
🇪🇸 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. Cobre Balance

Gestión de Virtual Balance Accounts (Cobre Balances)

La API de Virtual Balance Accounts (Cobre Balances) proporciona servicios para configurar, mantener y gestionar cuentas Virtual Balance. Para este propósito, se expone un conjunto de diferentes APIs y endpoints para que, mediante el uso de los servicios proporcionados, los clientes puedan registrar cuentas y obtener todas las cuentas registradas previamente y su información correspondiente.
Un endpoint de delete está disponible para que las cuentas puedan cerrarse desde la plataforma de Cobre para algunos proveedores.

Crear un Virtual Balance Account (Cobre Balance)#

La plataforma permite la creación de "Virtual Balance" en sus regiones operativas, a través de la API Crear un Cobre Balance. Estas cuentas son fundamentales para acceder a una gama de servicios de la plataforma, dependiendo de la geografía. Virtual Balance funciona como un activo versátil dentro del entorno de Cobre, mejorando la flexibilidad financiera.

Catálogo de Proveedores de Virtual Balance Accounts (Cobre Balances)#

Para el uso efectivo de la API Crear un Cobre Balance, se requiere un ID de proveedor junto con la especificación de una acción. Esto asegura que la API pueda procesar tu solicitud con precisión.
Solo la acción create dentro de la API de cuentas está disponible para proveedores de Virtual Balance.
Balances Colombia
Balances México
Balances Globales
La siguiente lista contiene todos los proveedores de Virtual Balance disponibles en Colombia, junto con sus servicios disponibles. Estas cuentas son fundamentales para acceder a una gama de servicios de la plataforma, incluidos pagos más rápidos.
CódigoProveedorCrearBalancesTransaccionesPagos
pr_col_cobreCobre Balance ColombiaSíSíSíSí

Acciones realizadas en un Virtual Balance#

🔑 Crear
🔍 Obtención
✍️ Actualizar
🪢 Vinculación de Cuenta
⛓️‍💥 Desvinculación de Cuenta
❌ Cerrar
Descripción: Creación de Virtual Balance Account.
Qué esperar después de la acción: Virtual Balance en estado Creado.
📘 Aprende más: 🔗 Crear un Cobre Balance

Transacciones de Virtual Balance Accounts (Cobre Balances)#

🔍 Obtención
🗂️ Historial de Saldo Diario
Descripción: 🔎 Obtener todas las transacciones relacionadas con todos los Virtual Balance, o con un Virtual Balance específico. También obtener transacciones relacionadas con un Virtual Balance específico.
Qué esperar después de la acción: Lista de información de transacciones (es decir, débitos y créditos) o información de transacción específica.
📘 Aprende más:
Obtener todas las transacciones del cliente
Obtener transacciones de la cuenta
Obtener una transacción

Cómo Empezar#

Antes de comenzar, recomendamos tener claridad sobre los pasos preliminares requeridos antes de usar esta solución.

Antes de usar esta API#

1
Al crear un Virtual Balance, usa el provider_id correcto según la región y moneda requerida
Usa el proveedor correcto basado en la región o moneda requerida. Ver la sección anterior Catálogo de Proveedores de Virtual Balance para más detalles.
2
Piensa en el número de Virtual Balance que necesitas
Decide si tener uno o múltiples Virtual Balance te ayudará con la gestión de información de pagos. Por ejemplo, es posible definir un Virtual Balance por Comerciante para una Plataforma de E-Commerce para que todas las transacciones relacionadas con el comerciante puedan rastrearse independientemente en cada Virtual Balance correspondiente.
3
Decide si vincular una cuenta Primaria tiene sentido para tu caso de uso
Los Virtual Balance con una Cuenta Primaria configurada, automáticamente transferirán cualquier transacción de crédito a esa Cuenta Primaria. Esto es útil para casos de uso de Cobranzas donde recibir fondos en Virtual Balance independientes tiene sentido, pero todos los fondos deben agregarse después en un solo Virtual Balance o cuenta local.
Ver Vinculación de Cuentas para más detalles.
4
Suscríbete a notificaciones de transacciones
Suscríbete a notificaciones de transacciones para recibir información sobre:
Créditos de transacciones (ej., accounts.balance.credit)
Débitos de transacciones (ej., accounts.balance.debit)
Ver Notificaciones y Suscripciones para más detalles

Qué esperar después de usar esta API#

1
Comienza a mover dinero
Enviar dinero
a cuentas locales - ver guías de Pagos Locales en Colombia y México
a otros Virtual Balance - usar otro Virtual Balance como destino
a wallets de stablecoin en ETH, Tron, Solana, Polygon, Base, y XRPL desde Virtual Balance Globales en USD
en operaciones masivas a cuentas locales - ver guía de Movimientos de Dinero Masivos
en transferencias programadas desde múltiples Virtual Balance a un Virtual Balance o a una cuenta local - ver guía del Programador de Movimiento de Dinero
Recibir dinero
de Bre-B, PSE, Nequi, Débito Directo Nequi, y Botón Bancolombia en Colombia - ver guía de Checkout y guía de Enlace Directo
de SPEI con CLABEs Virtuales en México - ver guía de CLABEs Virtuales
de wallets calientes de stablecoin en ETH/Polygon y Tron a Balances Globales USD
2
Obtener información de transacciones de Virtual Balance bajo demanda
Usa los endpoints de transacciones de Virtual Balance especificados en la sección correspondiente en esta guía para obtener los débitos y créditos que afectaron el Virtual Balance.
3
Rastrear débitos y créditos en un Virtual Balance
Recibe las notificaciones webhook para cada transacción de crédito y débito en un Virtual Balance cuando existe una suscripción activa a los tipos de evento accounts.balance.credit y accounts.balance.debit.
Ver Notificaciones y Suscripciones
4
Asignar claves Bre-B a Virtual Balance colombianos
Asignar claves Bre-B estáticas que se pueden compartir para recibir dinero en un Virtual Balance.
Ver guía de Claves Cobre
5
Convertir entre monedas
Convertir monedas en tiempo real para soportar casos de uso de transferencias transfronterizas
Ver CrossBorder Payments
Modified at 2026-02-20 18:48:05
Previous
Autenticación
Next
Vinculación de Cuentas
Built with