🇪🇸 Español
  • 🇺🇸 English
  • 🇪🇸 Español
  1. México
🇪🇸 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. México

Referencia de cuenta – CLABEs virtuales

Cuentas Receptoras Compartibles para Cobros en México (SPEI)#

Las CLABEs Virtuales son un tipo de Referencia de Cuenta en Cobre que permiten a las empresas cobrar fondos en México utilizando números de cuenta CLABE que son válidos dentro de la red SPEI. Estas CLABEs Virtuales pueden compartirse con clientes para que puedan enviar fondos MXN a través de su banco, mientras que el dinero es finalmente procesado y acreditado en el Cobre Balance asociado.
Las CLABEs Virtuales proporcionan una forma escalable de crear múltiples identificadores receptores para un solo balance—ideal para atribución de pagos, reconciliación y configuraciones de cobro multi-cliente.

1. Lo que Cobre Habilita con CLABEs Virtuales#

Con CLABEs Virtuales, Cobre permite a las empresas:
Crear números de cuenta CLABE Virtuales que son válidos dentro de SPEI
Asociar cada CLABE Virtual a un Cobre Balance de México (MXN)
Compartir CLABEs Virtuales con clientes para recibir transferencias bancarias
Cobrar fondos de cualquier institución capaz de enviar transferencias SPEI
Identificar qué CLABE Virtual recibió cada pago usando metadatos de transacción
Habilitar múltiples referencias receptoras por balance, soportando cobros escalados
Esto convierte un solo Cobre Balance en un destino de cobro multi-referencia para México.

2. CLABEs Virtuales en el Modelo Cobre#

En Cobre, las CLABEs Virtuales son Referencias de Cuenta de tipo virtual_clabe_accounts. Están vinculadas a una cuenta CLABE creada a través del endpoint Create Account, lo que significa que finalmente se mapean de vuelta a un Cobre Balance de México.
Conceptualmente:
Cobre Balance (MXN) = la cuenta donde terminan los fondos
CLABE Virtual = el identificador receptor compartible al que los clientes envían dinero
Transacción de Crédito SPEI = la evidencia de fondos recibidos en Cobre
Las CLABEs Virtuales deben entenderse como referencias vinculadas a una cuenta CLABE, y por lo tanto todas las transacciones son finalmente procesadas en la cuenta Cobre Balance asociada.

3. Capacidades Clave y Cómo Funcionan los Cobros#

3.1 Identificadores Receptores Compartibles#

Una CLABE Virtual puede compartirse con clientes para propósitos de cobro, permitiéndoles iniciar transferencias desde su institución financiera.

3.2 Múltiples CLABEs Virtuales por Balance#

Se recomienda crear múltiples CLABEs Virtuales asociadas con el mismo Cobre Balance, en lugar de crear solo una referencia por cuenta. Esto es especialmente relevante porque hay un número limitado de cuentas Cobre Balance de México que pueden usarse para crear CLABEs Virtuales.
Este diseño soporta casos de uso como:
Una CLABE Virtual por cliente
Una CLABE Virtual por factura
Una CLABE Virtual por línea de negocio o canal

3.3 Atribución a Través de Metadatos de Transacción#

Cuando un cliente transfiere fondos a una CLABE Virtual, el crédito aparece como una transacción de crédito SPEI (spei_credit) en el Cobre Balance asociado. La transacción incluye un campo account_reference que identifica qué CLABE Virtual recibió la transferencia.
Esto habilita una fuerte reconciliación y lógica de enrutamiento de pagos.

4. Ciclo de Vida y Control (Habilitado / Deshabilitado)#

Las CLABEs Virtuales tienen un ciclo de vida simple con dos estados:
habilitado (predeterminado): listo para recibir transacciones
deshabilitado: alcanzado después de invocar el método delete; las transferencias enviadas a la CLABE Virtual serán rechazadas
Esto proporciona controles operacionales para gestionar o retirar referencias receptoras sin cambiar el balance subyacente.

5. Transacciones, Reportes y Reconciliación#

Los cobros de CLABE Virtual generan transacciones de crédito SPEI (spei_credit) en el Cobre Balance asociado.
Desde una perspectiva de finanzas y operaciones, esto habilita:
Visibilidad a nivel de balance de todos los cobros entrantes
Atribución a nivel de referencia vía account_reference
Reconciliación escalable para operaciones de cobro de alto volumen
Dado que las CLABEs Virtuales se comportan como una capa de referencia, son ideales para empresas que necesitan coincidencia limpia entre cobros y registros internos.

6. Combinaciones Soportadas (México)#

La configuración soportada para CLABEs Virtuales incluye:
Tipo de Cuenta: Cobre Balance
Proveedor: pr_mex_cobre3
Geo: MEX
Tipo de Referencia de Cuenta: virtual_clabe_accounts
Formato de valor de ejemplo: 70301105231100001

7. Consideraciones Clave#

Al usar CLABEs Virtuales, ten en cuenta:
Debes tener un Cobre Balance de México para crear una referencia de CLABE Virtual.
Hay un número limitado de balances de México que pueden usarse para la creación de CLABEs Virtuales; por lo tanto, se recomienda crear múltiples CLABEs Virtuales por balance en lugar de solo una por cuenta.
Las cuentas Cobre Balance de México del proveedor pr_mex_cobre3 no pueden eliminarse si han sido usadas para crear CLABEs Virtuales.
Estas consideraciones son importantes para la arquitectura de cuentas a largo plazo y la planificación del ciclo de vida.

8. Resumen — Lo que Cobre Entrega con CLABEs Virtuales#

Con CLABEs Virtuales, Cobre habilita:
Referencias CLABE compatibles con SPEI compartibles para cobros en México
Múltiples referencias receptoras por Cobre Balance para escala y atribución
Reconciliación clara vía transacciones de crédito SPEI y metadatos account_reference
Controles simples de ciclo de vida (habilitado / deshabilitado con comportamiento de rechazo)
Un modelo estructurado para cobros en México usando rieles bancarios estándar (SPEI)
Modified at 2026-02-03 02:05:10
Previous
Llaves Bre-B estáticas
Next
Cobre Balance respaldados por CLABE
Built with