🇺🇸 English
  • 🇺🇸 English
  • 🇪🇸 Español
  1. Accounts
🇺🇸 English
  • 🇺🇸 English
  • 🇪🇸 Español
  • Cobre Intro
    • Welcome
    • Get started
    • Products
      • Local Payments
        • Local Payments with Cobre
        • Payouts
          • Colombia
            • Money Movements with Bre-B
            • Money Movements with Cobre Fast Pay
          • Mexico
            • Money Movements with CLABEs and SPEI Cards
          • Multi-region
            • Money Movements Scheduler
        • Payins
          • Colombia
            • Checkout
            • Request to Pay (R2P)
            • Direct Debit with Nequi
            • Static Bre-B Keys
          • México
            • CLABE-backed Virtual Balances Accounts (Cobre Balances)
            • Account Reference – Virtual CLABEs
        • Other feaures
          • Bulk Money Movements
          • Enabling Approval Workflows (Maker–Checker)
      • Cross Border Payments
        • Cross Border Payments with Cobre
      • Stablecoins
        • Global Payouts in Stablecoins
      • Connect
        • Connect bank accounts with Cobre
    • Other features
      • Account Verification
      • Notifications and subcriptions
      • Security at Cobre
      • Performance and throughput
  • Portal
    • Introduction & Quick Start
    • Authentication in Portal
    • Troubleshooting & Support
    • Movements
      • Approval Process (Maker-Checker)
      • Local Money Movement
      • Unitary Payment Initiation
      • Bulk Money Movement Initiation
      • Cross-Border Money Movements
      • Payment Links
      • Scheduler
    • Transactions
      • Transactions
    • Accounts
      • Account and Balance Management
      • Virtual CLABEs
    • Counterparties
      • Counterparties
    • Reports
      • Reports & Reconciliation
    • Settings
      • Users and Roles Management
      • Security and Control
    • Developers
      • Subscription management
  • Developers
    • API Guides
      • Quick Start
      • Authentication
      • Cobre Balances
        • Managing Virtual Balance Accounts (Cobre Balances)
        • Account Linkeage
      • Connect Accounts
        • Managing Connect Accounts
      • Counterparties
        • Managing Counterparties
      • Local Payments
        • Money Movement
        • Payouts
          • Colombia
            • Fast Pay & ACH
            • Bre-B
          • Mexico
            • SPEI
          • Cross-Region
            • Bulk Money Movements
            • Bulk Money Movements Approval
            • Money Movement Scheduler
        • Payins
          • Colombia
            • Cobre Keys with Bre-B
            • Checkout
            • Direct Link
            • Direct Debit
          • Mexico
            • Account Reference – Virtual CLABEs
      • Cross Border Payments
        • Cross Border Payments
        • Create Fx Quotes
        • Create a Cross Boder Money Movement
        • Fund your global Cobre Balance
      • Cross Features
        • Account Verification
        • Reconciliation with Cobre Reports in Colombia
        • Reports
        • Report Scheduler
        • Evidence API
        • Notifications & Subscriptions
      • Error Handling
        • Error Dictionary
      • Testing
        • General Testing
        • Testing Cases
        • Testing PSE and Bancolombia
    • API Explorer
      • Authentication API
        • Authentication
      • Cobre Balances
        • Create a Cobre Balance
        • Obtain all Accounts
        • Obtain one Account
        • Update an Account
        • Close a Cobre Balance
        • Obtain one Account Transactions
        • Obtain one Transaction
        • Obtain all Client Transactions
        • Obtain Account Daily Balance History
        • Assign or Change Primary Account
        • Unlinking Primary Account
      • Connect Accounts
        • Connect an Account
        • Obtain one Connected Account
        • Obtain all Connected Accounts
        • Obtain one Transaction
        • Obtain all Account Transactions
        • Obtain all Client Transactions
        • Update an account
      • Account Verifications
        • Obtain one Account Verification
        • Create an Account Verification
        • Obtain all Account Verifications
      • Account References
        • Create an Account Reference
        • List one Account Reference
        • List all Account References
        • Delete an Account References
      • Cobre Keys
        • Create a Key
        • Obtain all Keys
        • Obtain one Key
        • Cancel a Key
        • Block or Reactivate Keys
      • Counterparties
        • Account Debit Registration
          • Register a Counterparty for Direct Debit
          • Obtain all Registrations
          • Obtain one Registration
        • Create a Counterparty
        • Obtain one Counterparty
        • Obtain all Counterparties
        • Delete a Counterparty
      • Money Movements
        • Create a Money Movement
        • Obtain one Money Movement
        • Obtain all Money Movements
        • Return a Money Movement
      • Money movement Approvals
        • Approve a Money Movement
        • List all Money Movement Approvals
      • Money Movement Scheduler
        • Create a Money Movement Scheduler
        • List all Money Movement Schedulers
        • Cancel an Active Scheduler
      • Bulk Money Movement
        • Create a Bulk Money Movement
        • List all Bulk Money Movements
        • List one Bulk Money Movement
      • Bulk Money Movement Approvals
        • Bulk Money Movements Decision
      • Cross Border
        • Create a FX Quote
        • Obtain one FX Quote
        • Obtain all the FX Quotes
        • Create a Cross Border Money Movement
        • Obtain one Cross Border Money Movement
        • Obtain all the Cross Border Money Movements
      • Checkout
        • Create a Checkout
        • Obtain one Checkout
        • Obtain all Checkouts
        • Desactivate a Checkout
      • Evidence API
        • Evidence Requests
          • Obtain Evidence Request
          • Search Evidence Requests
        • Evidence Documents
          • Generate Upload Links
          • Generate Download Link
        • Evidence Information
          • Submit Evidence Information
      • Reports
        • Create a Report
        • Obtain all Reports
        • Generate Download Link for Selected Reports
        • Create a Cobre Balance Statement
      • Report Scheduler
        • Create a Report Scheduler
        • Obtain all Reports Schedulers
        • Delete a Report Scheduler
      • Notifications & Subscriptions
        • Subscribe to Events
        • Obtain all Subcriptions
        • Delete a Subscription
        • List all Available Events
    • Platform Catalogs
      • Mexican Bank Codes
      • Colombian Bank Codes
      • Transaction Types
      • Account Providers
    • Testing APIs
      • Create a Transaction Adjustment
      • Change a Money Movement Status
      • Transaction Adjustment (QA)
      • Change Money Movement Status (QA)
    • Reports Layout
      • Money Movements Layout
        • All Money Movements (CSV)
        • All Money Movements (JSON)
        • SPEI Money Movements (CSV)
        • LEGACY Money Movements (CSV)
      • Transactions Layout
        • All Transactions (CSV)
        • All Transactions (JSON)
        • Virtual Balance Account (Cobre Balance) Statement (PDF)
      • Counterparties Layout
        • All Counterparties (CSV)
      • Multicash Layout
        • Multicash Header (TXT)
        • Multicash Detail (TXT)
    • Notifications Layout
      • Account Events
        • Account Balance Credit
        • Account Balance Debit
      • Cobre Keys
        • Cobre Keys
      • Counterparties
      • Money Movement
        • Money Movement
      • Bulk Money Movement
        • Bulk Money Movement
      • Cross Border Money Movement
        • Cross Border Money Movement
      • Evidence Requests
        • Evidence Requests
      • Reports
        • Reports
  • Schemas
    • Counterparties
      • RequestBodies
        • Counterparty-request
      • Colombia
        • PayOut
          • Counterparty | Create Metadata Type CC (CO)
          • Counterparty | Response Metadata Type CC (CO)
          • Counterparty | Create Metadata Type CH (CO)
          • Counterparty | Response Metadata Type CH (CO)
          • Counterparty | Create Metadata Type DP (CO)
          • Counterparty | Response Metadata Type DP (CO)
          • Counterparty | Create Metadata Type Breb Key (CO)
          • Counterparty | Response Metadata Type Breb Key (CO)
          • Counterparty | Create Metadata Type Cobre Balance (CO)
          • Counterparty | Response Metadata Type Cobre Balance (CO)
        • PayIn
          • Counterparty | Create Metadata Type r2p (CO)
          • Counterparty | Response Metadata Type r2p (CO)
          • Counterparty | Create Metadata Type r2p Breb (CO)
          • Counterparty | Response Metadata Type r2p Breb (CO)
        • Secondary Counterparty
          • Secondary Counterparty Create Request (CO)
          • Secondary Counterparty Create Response (CO)
          • Secondary Counterparty Create Metadata Type NP (CO)
          • Secondary Counterparty Response Metadata Type NP (CO)
          • Secondary Counterparty Request Metadata Type LE
          • 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 Request (CO)
        • Counterparty | Create Response (CO)
      • Mexico
        • PayOut
          • Counterparty | Create Metadata Type Clabe (MX)
          • Counterparty | Response Metadata Type Clabe (MX)
          • Counterparty | Create Metadata Type SPEI Card (MX)
          • Counterparty | Response Metadata Type SPEI Card (MX)
        • Counterparty | Create Request (MX)
        • Counterparty | Create Response (MX)
      • Global
      • USA
        • Counterparty | Create Request (USA)
        • Counterparty | Create Response (USA)
        • Request Medatata Business
        • Response Medatata Business
        • Request Medatata Individual
        • Response Medatata Individual
      • Counterparty | List All Items
      • MEX Money Movement Return
    • Transactions
      • Global
        • Transaction | Debit Cross Border
        • Transaction | Credit 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 Top Up (CO) (col_top_up_credit)
          • Transaction | Credit FI (CO) (col_credit)
          • Transaction | Credit Cobre Balance (CO) (col_cb_credit)
          • Transaction | Credit Breb (CO) (breb_credit)
          • Transaction | Credit r2p (r2p_credit)
          • Transaction | Credit r2p Breb (CO) (r2p_breb_credit)
        • Transaction | Connect Obtain (CO)
        • Transaction | Cobre Balance Obtain (CO)
      • Mexico
        • Debit
          • Transaction | Debit FI (MX) (mex_debit)
          • Transaction | Debit SPEI (MX) (spei_debit)
          • Transaction | Debit Internal SPEI (MX)
        • Credit
          • Transaction | Credit FI (MX)
          • Transaction | Credit SPEI (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 | Debit Misc
      • Transaction | Credit Misc
      • Transaction | Adjustment Debit
      • Transaction | Adjustment Credit
    • 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 | Response Medatada Type SPEI
          • Money Movement Return | Create Response
      • Colombia
        • PayOut
          • Money Movement | Create Metadata Type Fast Pay
          • Money Movement | Response Metadata Type Fast Pay
          • Money Movement | Create Metadata Type ACH
          • Money Movement | Response Metadata Type ACH
          • Money Movement | Create Metadata Type Breb
          • Money Movement | Response Metadata Type ACH
        • PayIn
          • Money Movement Direct Link | Create Metadata Rail PSE
          • Money Movement Direct Link | Response Metadata Rail PSE
          • Money Movement Direct Link | Response Metadata Rail Bancolombia
          • Money Movement Direct Link | Response Metadata Rail Nequi
          • Money Movement Direct Link | Create Metadata Rail r2p Breb
          • Money Movement Direct Link | Response Metadata Rail r2p Breb
        • 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 Verification Create Metadata Type mex_acc_ownership_1
          • Account Verification Response Metadata Type mex_acc_ownership_1
          • Account Verifications List All Items
        • 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 Metadata (CO)
          • Cobre Balance | Create Response (CO)
        • Global
          • Cobre Balance | Create Metadata (Global)
          • Cobre Balance | Create Response (Global)
        • Cobre Balance | Create Request
        • Cobre Balances | List All Items
        • Account_request_PATCH
        • Account_request_CONNECT_PATCH
      • Daily Balance
        • Daily Balance Obtain Response
        • Daily Balance Historiy List All Items
      • Account Connect
        • Mexico
          • Account Conect | Create Metadata (MX)
          • Account Connect | Response Metadata (MX)
        • Colombia
          • Account Conect | Create Metadata (CO)
          • Account Connect | Response 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 Create Response
        • Cross Border Money Movement Obtain Response
        • Cross Border Money Movements List All Items
      • FX Quote
        • FX Static Quote
          • FX Quote Static | Create Request
          • FX Quote Static | Create Response
        • FX Rolling Quote
          • FX Quote Rolling | Create Request
          • FX Quote Rolling | Create Response
        • FX Quote | Create Request
        • FX Quote | List All Items
        • FX Quote | Metadata Quote Tiers
        • FX Quote | Metadata Penalization Tier
        • FX Quote | Metadata Fees Breakdown
    • Reports
      • Download
        • Report Download Create Request
        • Report Download Create Response
      • Reports Create Request
      • Reports Create Response
      • Reportes Create Metadata
      • Request Body Reports
      • Reports List All Items
      • Reports Object
    • Error Model
      • Error-model
    • Report Scheduler
      • Report Schedulers | Create Request
      • Report Schedulers | Create Response
  1. Accounts

Virtual CLABEs

Virtual CLABEs are valid CLABE account numbers within the SPEI network that you can generate and associate with a Cobre Balance account in Mexico. Their primary purpose is fund collection: you can share these numbers with your customers so they can make transfers from any financial institution, and the funds will be credited directly to your Cobre Balance account.

How It Works#

Each Virtual CLABE is an account reference linked to a Cobre Balance account. When a customer makes a SPEI transfer to that number, the transaction is processed and the funds become available in the associated Cobre Balance account. Through the Account Number column, you can identify exactly which Virtual CLABE received each transfer.
A Virtual CLABE can have two possible states throughout its lifecycle:
Enabled: The default state upon creation. The reference is active and can receive transfers.
Disabled: The state reached after deleting the reference. Any transfer sent to that number will be automatically rejected.

Key Capabilities to Keep in Mind#

Multiple references per account: A single Cobre Balance account can have several Virtual CLABEs associated with it. Since the number of available Cobre Balance accounts in Mexico is limited, it is recommended to create multiple Virtual CLABEs on the same account rather than one reference per account.
Reference-level traceability: Every incoming SPEI credit transaction includes the identifier of the Virtual CLABE that received it, making reconciliation and per-customer or per-purpose tracking straightforward.
Account deletion restriction: A Cobre Balance account that has been used to create Virtual CLABEs cannot be deleted.
SPEI network operation: All transactions are processed under the SPEI standard, ensuring compatibility with any financial institution in Mexico.

How to Get Started with Virtual CLABEs in the Portal#

Contact your KAM to enable this feature in the Portal

Step 1 – Verify you have a Cobre Balance account in Mexico#

Having an active Cobre Balance account in Mexico (Institution: Cobre Balance Mexico 3) is a prerequisite before creating any virtual references.

Step 2 – Create a Virtual CLABE#

Go to the Virtual CLABEs sub-module and click + Create Virtual CLABE.
Captura de pantalla 2026-02-19 a la(s) 2.44.37 p.m..png

Step 3 – Associate the Virtual CLABE to a Cobre Balance#

Select the Cobre Balance account you want to associate the Virtual CLABE with, and set an alias to easily identify it in the Portal.
Captura de pantalla 2026-02-19 a la(s) 2.46.18 p.m..png
Alternatively, you can create the Virtual CLABE directly from the Cobre Balance account you want to associate it with, via the Accounts screen.
Captura de pantalla 2026-02-19 a la(s) 3.00.47 p.m..png
Note: By default, up to 5 Cobre Balance accounts are allowed to have Virtual CLABEs assigned. This limit exists to control Virtual CLABE creation across your accounts. You can adjust this setting by contacting your KAM. An informational banner showing the current limit is displayed in the top-right corner of the Virtual CLABEs screen, next to the Create Virtual CLABE button.

Step 4 – Share the account number with your customer#

Provide the Virtual CLABE number to your counterparties so they can initiate transfers. It can be used from any bank or financial institution connected to the SPEI network.

Step 5 – Receive and monitor funds#

Funds will arrive as Credit via SPEI transactions in your Cobre Balance account. In the Transactions screen, you can check the Virtual CLABE column on each transaction to identify which Virtual CLABE account number received the funds.
Captura de pantalla 2026-02-19 a la(s) 3.15.38 p.m..png
You can also monitor all transactions received by a specific Virtual CLABE from the Virtual CLABEs sub-module. Click on any Virtual CLABE in the list to open its detailed view.
Captura de pantalla 2026-02-19 a la(s) 3.18.56 p.m..png

Step 6 – Delete a Virtual CLABE when needed#

If a Virtual CLABE should no longer receive funds, you can delete it using the Delete Virtual CLABE option, available both in the Virtual CLABE detailed view and via the tooltip (Trash icon on the right side of each entry in the table) in the Virtual CLABEs screen. Once in Disabled state, all incoming transfers to that number will be automatically rejected. Once deleted, the Virtual CLABE cannot be reactivated.
Captura de pantalla 2026-02-19 a la(s) 3.22.28 p.m..png

Extra tip – Search and filter your Virtual CLABEs#

In the Virtual CLABEs screen, use the search option to filter your Virtual CLABEs by account number, alias, or associated Cobre Balance account (using the account ID).
Captura de pantalla 2026-02-19 a la(s) 3.38.33 p.m..png
A new column named metadata.account_reference is also available in your reports and exports, which you can use to filter transactions associated with your Virtual CLABEs.

Frequently Asked Questions#

Can I have multiple Virtual CLABEs for the same account?
Yes. In fact, it is the recommended approach. Since the number of Cobre Balance accounts in Mexico is limited, creating multiple Virtual CLABEs associated with the same account is the best way to optimize available resources.
What happens if a customer transfers funds to a disabled Virtual CLABE?
The transfer will be automatically rejected. The customer will receive a refund according to the SPEI system's standard timelines and processes.
Can I delete a Cobre Balance account that has Virtual CLABEs associated with it?
No. Cobre Balance accounts from institution Cobre Balance Mexico 3 that have been used to create Virtual CLABEs cannot be deleted.
Are Virtual CLABEs compatible with all banks in Mexico?
Yes. Since they operate within the SPEI network, they are compatible with any participating financial institution in Mexico.
Can I reactivate a previously deleted Virtual CLABE?
No. Once deleted, the Virtual CLABE cannot be reactivated.
Modified at 2026-02-20 21:43:10
Previous
Account and Balance Management
Next
Counterparties
Built with