1. Using Cobre
🇺🇸 English
  • 🇺🇸 English
  • 🇪🇸 Español
  • Cobre Intro
    • Welcome
    • Get started
    • Connect Cobre's Documentation to AI
    • 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
            • Request to Pay (R2P)
            • 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 subscriptions
      • Security at Cobre
      • Performance and throughput
    • Using Cobre
      • Integrating Cobre from ERPs
      • Bre-B Payouts with Payment Instruments of Your Ecosystem
      • Cobre for Lenders
  • 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
          • Global
            • Global payouts in stable
          • Cross-Region
            • Bulk Money Movements Approval
            • Money Movement Scheduler
            • Bulk Money Movements
        • Payins
          • Colombia
            • Cobre Keys with Bre-B
            • Checkout
            • Direct Link
            • Direct Debit
          • Mexico
            • Direct Link
            • 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
      • Certification
        • Certification Process
        • Questionnaire
    • API Explorer
      • Build with AI
      • 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
        • Create an Account Verification
        • Obtain one 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 Subscriptions
        • Delete a Subscription
        • List all Available Events
    • Platform Catalogs
      • Colombian Bank Codes
      • Mexican Bank Codes
      • Account Providers
      • Transaction Types
      • Money Movement Statuses
    • 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 Debit
        • Account Balance Credit
      • Cobre Keys
        • Cobre Keys
      • Counterparties
        • 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 Cobre Balance (CO)
          • Counterparty | Response Metadata Type Cobre Balance (CO)
          • Counterparty | Create Metadata Type Breb Key (CO)
          • Counterparty | Response Metadata Type Breb Key (CO)
          • Counterparty | Create Metadata Type QR (CO)
          • Counterparty | Response Metadata Type QR (CO)
          • 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)
        • PayIn
          • Counterparty | Create 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)
        • PayIn
          • Counterparty | Create Metadata Type r2p (MX)
          • Counterparty | Response Metadata Type r2p (MX)
        • Counterparty | Create Request (MX)
        • Counterparty | Create Response (MX)
      • Global
        • Counterparty | Global CP Request
        • Counterparty | Global Deposit NP request
        • Counterparty | Global Deposit NP response
        • Counterparty | Global Deposit LE request
        • Counterparty | Global Deposit LE response
        • Counterparty | Global CP Response
      • USA
        • Counterparty | Create Request (USA)
        • Counterparty | Create Response (USA)
        • Request Medatata Business
        • Response Medatata Business
        • Request Medatata Individual
        • Response Medatata Individual
      • MEX Money Movement Return
      • Counterparty | List All Items
    • 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
        • PayIn
          • Money Movement Direct Link | Create Metadata Rail r2p SPEI
          • Money Movement Direct Link | Response Metadata Rail r2p SPEI
      • Colombia
        • 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
        • 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 Bre-B
          • Money Movement | Response Metadata Type Bre-B
      • Global
        • Payout in stable
          • Money Movement | Create Metadata Type Global (stable)
          • Money Movement | Response Metadata Type Global (stable)
      • Money Movement | List All Items
      • Money Movement | Create Response
    • 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
      • Reportes Create Metadata
      • Request Body Reports
      • Reports Create Response
      • Reports List All Items
      • Reports Object
    • Error Model
      • Error-model
    • Report Scheduler
      • Report Schedulers | Create Request
      • Report Schedulers | Create Response
  1. Using Cobre

Bre-B Payouts with Payment Instruments of Your Ecosystem

Use Case: Local Payments with Bre-B Using the Payment Instruments of Your Ecosystem#

Cobre enables Payment Service Providers (PSPs) that offer their own payment instruments or manage those offered by third parties to enable local Bre-B payments using those instruments—even if the denomination of those instruments is expressed in currencies or assets other than COP. Thanks to our operational model, Cobre enables the effective execution of payments initiated by users of these instruments and allows the repayment of disbursed values in a currency other than COP.
Cobre receives your foreign currency and, when combined with instant local payouts, enables PSPs to offer a smooth in-person payment experience at merchants that accept Bre-B QR codes or Bre-B transfers.
This guide explains how we achieve this.

1. What Cobre Enables for PSP Apps#

With Cobre, PSPs can:
Maintain balances denominated in USD
Instruct Cobre to pay COP at the moment of in-person payment
Enable local merchant payments using Bre-B keys or Bre-B QR codes
Support dynamic and static QR payment flows
Receive real-time confirmation of payment success or failure
Maintain full traceability of the flow of funds (receipt and delivery)

2. The Payment App Flow in the Cobre Model#

Conceptually, an App payment via Bre-B settled in USD involves two coordinated steps:
1.
Cross-Border Money Movement — Cobre receives funds in USD.
See Cross Border Payments with Cobre
2.
Local Money Movement (Bre-B Payout) — Sends equivalent funds in COP to the merchant via Bre-B.
See Money Movements with Bre-B
Within the Cobre model:
App funds are reflected in Cobre Balances (USD / COP).
Merchants are represented as Counterparties, identified by Bre-B keys.
Each step generates its own Money Movement and resulting Transactions.
Notifications provide real-time feedback for both stages.
This separation guarantees transparency, pricing clarity, and operational control.

3. Key Capabilities for App Payments via Bre-B#

3.1 QR-Based Payment Initiation#

Typical payment app behavior:
The user scans a Bre-B QR code at the point of sale.
If the QR is dynamic, it includes the amount to be paid.
If the QR is static, the user enters the amount in the app.
The QR resolves to a Bre-B key and the merchant’s identity.
This provides the payment context needed to proceed.

3.2 Conversion Quote and User Confirmation#

When the app’s funds are in USD, settling the payment requires receiving funds at an agreed conversion rate between Cobre and the PSP that compensates the local payout.
At this stage:
The app requests an Conversion quote USD → COP
The quote specifies the COP amount to be delivered — i.e., the amount sufficient to cover the payment
The user reviews and accepts the value in the app
This step guarantees transparency and user consent before enabling COP funds.

3.3 Cross-Border Money Movement (Enabling COP Balance)#

Once the amount is accepted:
The app executes a cross-border money movement
Payments are executed in COP
COP liquidity becomes available for the local payment
This step connects the app’s global funding with Colombia’s local payment rails.

3.4 Local Bre-B Payout to the Merchant#

After COP funds are enabled:
The app initiates a local payout via Bre-B
Funds are sent in COP to the Bre-B key contained in the QR
The merchant receives the funds as an instant local transfer
From the user’s perspective, this appears as a single payment action.

3.5 Real-Time Notifications and Status Tracking#

Cobre provides event notifications covering both stages:
Result of COP balance enablement
Completion or rejection of the Bre-B local payout
PSPs can:
Immediately confirm payment success in the app’s UX
Detect failures and display clear error states
Trigger retries or alternative flows if necessary
This is critical for in-person payment experiences.
See Notifications and subscriptions

4. Speed, Settlement, and Reliability#

This two-step flow is designed for speed and predictability:
COP enablement executes immediately after user confirmation
Bre-B payouts typically complete in seconds
Each step has a clear final state (completed or failed)
There is no dependency on banking cut-off times
This makes the experience suitable for point-of-sale app payments.

5. Typical PSP App Use Cases#

Common scenarios include:
Payments in physical stores at Bre-B-enabled merchants
Payment apps funded in USD that spend locally in COP
QR-based merchant acceptance without cards
Super-apps offering real-time merchant payments
PSPs expanding app usability in Colombia
Cobre is especially valuable for PSPs connecting global app funding with local merchant acceptance.

6. Transactions, Reporting, and Reconciliation#

Each app payment generates:
A transaction for COP enablement
A transaction for the Bre-B payout
Clear references linking both steps to a single user payment intent
This allows PSPs to reconcile:
App debits vs. COP enablement
COP-enabled amounts vs. local payouts
Merchant settlements with full traceability

7. Summary — What Cobre Offers for PSP Apps#

Cobre enables PSPs in Colombia to:
Fund payment apps in USD
Enable COP funds at the moment of payment
Execute Bre-B payments via QR codes or keys
Support real-time in-person payments
Receive immediate confirmation of results
Maintain unified reporting across conversions and local payouts
By orchestrating local currency enablement and Bre-B payouts, Cobre allows international PSPs to offer simple, fast, and scalable app payments across Colombia.
Modified at 2026-03-24 19:31:30
Previous
Integrating Cobre from ERPs
Next
Cobre for Lenders
Built with