1. Movements
🇺🇸 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
            • Money Movements with Cobre ACH
          • Mexico
            • Money Movements with CLABEs and SPEI Cards
          • United States
            • Money Movements with Fedwire
          • Multi-region
            • Money Movements Scheduler
        • Payins
          • Refunds at Cobre
          • Colombia
            • Checkout
            • Request to Pay (R2P) Colombia
            • Direct Debit with Nequi
            • Static Bre-B Keys
            • Transfer-In
          • México
            • Request to Pay (R2P) Mexico
            • CLABE-backed Virtual Balances Accounts (Cobre Balances)
            • Virtual CLABEs
          • United States
            • Fedwire Payins at Cobre
        • Other features
          • Bulk Money Movements
          • Enabling Approval Workflows (Maker–Checker)
          • Named Accounts in Mexico
      • Cross Border Payments
        • Cross Border Payments with Cobre
        • International Payments
          • International Payments with Cobre
          • SWIFT Payouts
          • SWIFT Payins
      • Stablecoins
        • Stablecoins with Cobre
        • Global Payins in Stablecoins
        • Global Payouts in Stablecoins
        • Stablecoin Funding (On-Ramp & Off-Ramp)
        • StableFX
        • COPco & Rewards
      • Connect
        • Connect bank accounts with Cobre
    • Other features
      • Account Verification
      • Notifications and subscriptions
      • Security at Cobre
      • IP Whitelisting
      • Performance and throughput
      • Reconciliation at Cobre
    • Using Cobre
      • Bre-B Payouts with Payment Instruments of Your Ecosystem
      • Cobre for Lenders
      • Integrating Cobre from ERPs
  • Portal
    • Authentication in Portal
    • Troubleshooting & Support
    • Introduction & Quick Start
    • Movements
      • Refunds - Payer Data Capture Flow
      • Approval Process (Maker-Checker)
      • Local Money Movement
      • Unitary Payment Initiation
      • Bulk Money Movement Initiation
      • Scheduler
      • Payment Links
      • Cross-Border Money Movements
    • Transactions
      • Transactions
    • Accounts
      • Account and Balance Management
      • Account References
        • Virtual CLABEs
        • Transfer Accounts (Transfer-In)
    • Counterparties
      • Counterparties
    • Reports
      • Reports & Reconciliation
    • Settings
      • Users and Roles Management
      • Security and Control
    • Developers
      • API credentials management
      • Subscription management
    • Subclients
      • Subclient Management - Payins Colombia
      • Subclient Management - Names Accounts MX
  • Developers
    • API Guides
      • Quick Start
      • Authentication
      • Cobre Balances
        • Managing Virtual Balance Accounts (Cobre Balances)
        • Account Linkeage
        • Named Accounts (MX)
      • Connect Accounts
        • Managing Connect Accounts
      • Counterparties
        • Managing Counterparties
      • Local Payments
        • Money Movement
        • Payouts
          • Colombia
            • Fast Pay & ACH
            • Bre-B
          • Mexico
            • SPEI
          • United States
            • Fedwire Payouts
          • Cross-Region
            • Money Movements Approval
            • Bulk Money Movements
            • Bulk Money Movements Approval
            • Money Movement Scheduler
        • Payins
          • Refund API
          • Colombia
            • Cobre Keys with Bre-B
            • Checkout
            • Direct Link
            • Direct Debit
            • Transfer-In
            • Subclient Associated Movements
          • Mexico
            • Account Reference – Virtual CLABEs
            • Direct Link
            • Processing Refunds in Mexico
          • United States
            • Fedwire Payins
      • Cross Border Payments
        • Cross Border Payments
        • Create Fx Quotes
        • Create a Cross Boder Money Movement
        • Fund your global Cobre Balance
        • International Payments
          • SWIFT Payouts
          • SWIFT Payins
          • Create a Generic Money Movement
      • Cross Features
        • Account Verification
        • Reports
        • Report Scheduler
        • Evidence API
        • Notifications & Subscriptions
        • FX Alerts
      • Reconciliation
        • Payouts Reconciliation
        • Payins Reconciliation in Colombia
        • Payins Reconciliation in México
        • Opening and Closing Balance Reconciliation
        • Account Linkage Reconciliation
      • Testing
        • Testing Cases
        • Testing PSE and Bancolombia
        • General Testing
      • Certification
        • Certification Process
        • Questionnaire
      • Stablecoins
        • Stablecoins
        • Managing Stablecoin Balances & Wallets
        • Stablecoin Payins
        • Stablecoin Payouts
        • Stablecoin Funding (On/Off-Ramp)
        • StableFX
        • COPco Rewards
        • Global payouts in stable
      • Others
        • Managing API and Product Changes
        • Security Considerations
        • Performance Guidelines: Rate and Burst Limit Considerations
    • API Explorer
      • Authentication
        • Authentication
      • Accounts
        • Create or Connect an Account
        • Obtain all Accounts
        • Obtain one Account
        • Update an Account
        • Close a Cobre Balance
        • Obtain an Account Transactions
        • Obtain an Account Transaction
        • Obtain all Transactions
        • Obtain one Transaction
        • Obtain Account Daily Balance History
        • Assign or Change Primary Account
        • Unlinking Primary 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 Reference
        • Generate a Certificate for your Account Reference
      • 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
        • 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
      • Alerts
        • Create Alert
        • Obtain All Alerts
        • Obtain One Alert
        • Deactivate An Alert
      • Subclients
        • Create a Subclient
        • Obtain all Subclients
        • Obtain one Subclient
      • Refunds
        • Create a Refund
        • Obtain one Refund
        • Obtain a Refund Summary
        • Obtain all Refunds
    • Development Toolkit
      • How to integrate with Cobre
      • Build with AI
      • Create a Solution Design with AI
      • Generate Code with MCP
      • Build with the Cobre Dev Agent plugin
      • Explore API Workflow Examples
      • Explore the APIs with Postman
    • Platform Catalogs
      • Colombian Bank Codes
      • Mexican Bank Codes
      • Account Providers
      • Transaction Types
      • Money Movement Statuses
      • Error Dictionary
    • 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
        • Direct Debit Registration
      • Money Movement
        • Money Movement
      • Bulk Money Movement
        • Bulk Money Movement
      • Cross Border Money Movement
        • Cross Border Money Movement
      • Evidence Requests
        • Evidence Requests
      • Reports
        • Reports
      • Alerts
        • FX Alerts
      • Account References
        • Self-custodian wallet
        • Transfer-in
      • Subclients
        • Subclients
      • Refunds
        • Refunds
  • Schemas
    • Counterparties
      • 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 | Response Metadata Type r2p (CO)
          • 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
          • 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 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 SPEI Card (MX)
          • Counterparty | Response Metadata Type Clabe (MX)
        • PayIn
          • Counterparty | Create Metadata Type r2p (MX)
          • Counterparty | Response Metadata Type r2p (MX)
        • Counterparty | Create Response (MX)
        • Counterparty | Create Request (MX)
        • Counterparty | Money Movement Return (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
        • Counterparty | Create Request (USA)
        • Counterparty | Create Response (USA)
      • Generic
        • Counterparty | Generic CP Request
        • Counterparty | Generic CP Response
        • Payment Information | SWIFT
        • Payment Information | SEPA
        • Payment Information | CIPS
        • Payment Information | Fedwire
      • Counterparty | List All Items
    • Authentication
      • Authentication | Response
      • Authentication | Request
    • 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 r2p (r2p_credit)
          • Transaction | Credit Breb (CO) (breb_credit)
          • Transaction | Credit r2p Breb (CO) (r2p_breb_credit)
        • Transaction | Connect Obtain (CO)
        • Transaction | Cobre Balance Obtain (CO)
      • Mexico
        • 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 | Return SPEI (MX)
        • Transaction | Cobre Balance Obtain (MX)
      • Transactions | Connect List All Items
      • Transaction | Debit Misc
      • Transaction | Credit Misc
      • Transaction | Adjustment Debit
      • Transaction | Adjustment Credit
      • Transactions | Cobre Balance List All Items
      • Transaction Metadata | global_credit
      • Transaction Metadata | global_debit
      • Transaction Metadata | stable_payout_debit
      • Transaction Metadata | onramp_credit
      • Transaction Metadata | onramp_debit
      • Transaction Metadata | offramp_credit
      • Transaction Metadata | offramp_debit
      • Transaction Metadata | reward_credit
      • Transaction Metadata | cbmm_debit (StableFX)
      • Transaction Metadata | cbmm_credit (StableFX)
      • Transaction | Cobre Balance Obtain (Global/Stable)
      • Transaction Metadata | fedwire_credit
      • Transaction | Cobre Balance Obtain (USA)
      • Transaction Metadata | fedwire_debit
      • Transaction Metadata | swift_credit
      • Transaction Metadata | swift_debit
    • 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
        • PayIn
          • Money Movement Direct Link | Create Metadata Rail r2p SPEI
          • Money Movement Direct Link | Response Metadata Rail r2p SPEI
      • Colombia
        • PayOut
          • Money Movement | Create Metadata Type Fast Pay
          • Money Movement | Response Metadata Type Bre-B
          • Money Movement | Create Metadata Type Bre-B
          • Money Movement | Response Metadata Type Bre-B Split
          • Money Movement | Response Metadata Type Fast Pay
          • Money Movement | Create Metadata Type ACH
          • Money Movement | Response Metadata Type ACH
          • Money Movement | Response Metadata Type Bre-B
        • PayIn
          • Money Movement Direct Link | Create Metadata Rail r2p
          • 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
      • Global
        • Payout in stable
          • Money Movement | Create Metadata Type Global (stable)
          • Money Movement | Response Metadata Type Global (stable)
          • Money Movement | Create Metadata Type Stable Payout
          • Money Movement | Response Metadata Type Stable Payout
      • United States
        • PayOut
          • Money Movement | Create Metadata Type Fedwire
          • Money Movement | Response Metadata Type Fedwire
        • PayOuts
      • Generic
        • Money Movement | Create Metadata Type Generic
        • Money Movement | Response Metadata Type Generic
      • SWIFT
        • swift_metadata_create_request
        • swift_metadata_response
      • Money Movement | List All Items
      • Money Movement | Create Metadata Type On-Ramp / Off-Ramp
      • Money Movement | Response Metadata Type On-Ramp / Off-Ramp
      • 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 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 Verification Response Metadata Type col_key_ownership_2
          • Account Verification Create Metadata Type col_key_ownership_2
        • Account Verification Create Response
        • Account Verifications List All Items
      • Account References
        • Account References Request
        • Account Reference Response
        • List all account references
        • Account References Request (Self-Custodian Wallet)
        • Account Reference Response (Self-Custodian Wallet)
        • Account Reference Certificate Generation Response
      • Daily Balance
        • Daily Balance Historiy List All Items
        • Daily Balance Obtain Response
      • Cobre Balances and Connect Accounts
        • Mexico
          • Cobre Balance | Create Metadata (MX)
          • Cobre Balance | Create Response (MX)
          • Connect Account | Response Metadata (MX)
          • Connect Account | Create Metadata (MX)
        • Colombia
          • Cobre Balance | Create Metadata (CO)
          • Connect Account | Create Metadata (CO)
          • Cobre Balance | Create Response (CO)
          • Connect Account | Response Metadata (CO)
        • Global
          • Cobre Balance | Create Response (Global)
          • Cobre Balance | Create Response (Stable)
          • Cobre Balance | Create Metadata (Global)
          • Cobre Balance | Create Metadata (Stable)
        • USA
          • Cobre Balance | Create Metadata (USA)
          • Cobre Balance | Create Response (USA)
        • Cobre Balance | Create Request
        • Connect Account | Create Request
        • Accounts | List All Items
        • Account | Update Request
    • 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 | Delete
        • Checkout | Create Request
        • Checkout | Create Response
        • Checkout | List All Items
    • Notifications
      • Subscription | Create Response
      • Subscription | Create Request
      • Subscription | List All Items
      • Subscribable Events | List All Items
      • Subscribable Events | Metadata
    • Evidence Request
      • Schemas
        • Error
        • Document Type
        • Information Type
        • Evidence Request Status
        • Document Status
        • Information Status
        • Information
        • Evidence Request
        • Evidence Id
        • Upload Intent
        • Evidence Request Id
        • Evidence
        • Document
        • Headers
        • Counterparty Information Data
        • Freeze Of Funds Data
      • RequestBodies
        • Upload Intent Request
    • Cross Border
      • Cross Border Money Movement
        • Cross Border Money Movement Create Request
        • Cross Border Money Movement Create Response
        • CBMM Obtain Response | Static Quote
        • CBMM Obtain Response | Rolling Quote
        • Cross Border Money Movements List All Items
      • FX Quote
        • FX Static Quote
          • FX Quote Static | Create Response
          • FX Quote Static | Cross Border Response
        • FX Rolling Quote
          • FX Quote Rolling | Create Response
          • FX Quote Rolling | Cross Border Response
        • FX Quote | List All Items
        • FX Quote | Metadata Quote Tiers
        • FX Quote | Metadata Penalization Tier
        • FX Quote | Metadata Fees Breakdown
        • FX Quote | Create Request
    • Reports
      • Download
        • Report Download Create Request
        • Report Download Create Response
      • Reports Create Request
      • Reports Create Response
      • Reports Create Metadata
      • Reports List All Items
      • Cobre Balance Statement Request
      • Cobre Balance Statement Response
    • Error Model
      • Error Model
      • Error Model v2
    • Report Scheduler
      • Report Schedulers | Create Request
      • Report Schedulers | Delete Response
    • Alerts
      • Create Alert
      • Alert Object
      • List All Alerts
      • Alert | Metadata Type fx_rate
    • Subclients
      • Subclients | Create Request
      • Subclients | Create Response
    • Refunds
      • Refunds | Create Response
      • Refund Summary | Create Response
      • Refunds | List Response
  1. Movements

Refunds - Payer Data Capture Flow

What This Page Covers#

For most refund rails, Cobre already has everything it needs to send the money back — the payer's account data travels with the original payin, so the refund settles automatically with no action from them. PSE and Bancolombia are the exception: those rails don't hand Cobre the payer's destination account, so the payer has to provide it before Cobre can execute the payout.
When that happens, Cobre sends the payer a secure link where they enter their account details, confirm them, and verify their identity. This page walks through exactly what the payer sees on that link, so you can set expectations with them and answer support questions when they come up.
For the refund model itself (what a refund is, how it's requested, full lifecycle) see Refunds at Cobre and the Refund API guide.

When Your Payer Needs to Act#

A refund only requires payer input on r2p_pse and r2p_bancolombia. On every other supported rail (direct_debit/Nequi Tokenization, r2p_breb, r2p_nequi, breb_credit) the refund resolves and pays out automatically — the payer never sees a link.
For PSE and Bancolombia, the refund is created in waiting_for_information status and Cobre generates:
A capture link for the payer to open and complete.
An expiration timestamp for that link.
Once the payer submits and confirms their details, the refund moves to processing and follows the same lifecycle as every other rail from there (processing → completed / failed / rejected). See the Refund API guide for the full state diagram and webhook events.
If the payer doesn't complete the link before it expires, the refund is rejected. You'll need to trigger a new refund for the payer to try again.

The Payer's Experience, Step by Step#

The capture link opens a standalone, mobile-friendly page — no Cobre account or login required. It's branded with your business name and Cobre's "generated securely by Cobre" footer, so payers recognize it as a legitimate part of completing their refund, not a separate unrelated request.
The screenshots below are for reference only. The real UI may vary subtly (copy, styling, field order).

1. Choosing how to receive the refund#

01-destination-form-cuenta-empty.png
Captura de pantalla 2026-11-10 a la(s) 1.05.01 p.m..png
The page opens with the refund context already filled in — your business name, the refund amount, and a reference to the original operation (for example, "[Business name] autorizó un reembolso de [amount] para la operación •••• 1234").
The payer picks one of two destination types:
Cuenta (bank account)
FieldDescription
Nombre del TitularName on the destination account
Tipo de documentoID type (dropdown)
Número de documentoID number
Tipo de cuentaAccount type, e.g. Ahorros (dropdown)
Número de cuentaDestination account number
Entidad financieraDestination bank (dropdown, shown with the bank's logo)
Bre-B
FieldDescription
Nombre del TitularName on the Bre-B key
Tipo de documentoID type (dropdown)
Número de documentoID number
Llave / identificadorThe payer's Bre-B key
The Confirmar y solicitar el reembolso button stays disabled until every required field is filled and the consent checkbox (next section) is checked.

2. Authorization and consent#

03-consent-overlay.png
Below the form, a data-processing disclosure explains that the information the payer submits will be used to execute and credit the refund, handle failures or claims, and keep a traceability record — processed by Cobre and its providers on your business's behalf.
The payer must check "He leído y acepto la Autorización y consentimiento". The linked text opens an overlay with the full consent language, covering:
What the data will be used for and who processes it.
The payer's rights (access, correction, deletion, revoking authorization, requesting proof of use, filing complaints with the SIC).
Acceptance of the data processing policy.
The payer taps Aceptar to close the overlay; the checkbox is then available to mark on the main form.

3. Confirming the details#

04-confirma-tus-datos-review.png
Submitting the form moves to a "Confirma tus datos" review screen, showing:
Resumen — the amount to be received.
Detalle — the original request number, the refund reference, the destination entity, the masked account number, and the account holder's name.
A final checkbox confirms the payer understands the deposit will appear on their bank statement under Cobre's legal entity name, and that the data shown is correct and will be used exactly as entered. The payer can go Volver (back to edit) or continue with Confirmar y continuar.

4. Verifying identity#

05-otp-verification.png
Confirming triggers a one-time-code check: a modal shows "Verifica tu identidad", with a 6-digit code sent to the payer's masked email (e.g. a***@correo.com). The payer enters the code and taps Verificar código.
A countdown (starting at 60 seconds) gates the Reenviar código button — it only becomes active once the countdown reaches zero, to prevent request spamming.

5. Processing#

06-processing.png
Once the code is verified, the refund request is submitted and the page shows "Estamos procesando tu reembolso", with the same Resumen/Detalle summary as the confirmation step. This is the moment the refund transitions from waiting_for_information to processing on your side — any webhook subscriber receives refund.status.processing at this point.
The page offers a "Volver a [tu comercio]" button so the payer can return to your site without waiting for the final result (Only if you use the redirect_url optional field in the API).

6. Final outcome#

Captura de pantalla 2026-11-10 a la(s) 1.03.43 p.m..png
When the underlying payout settles, the payer's status page updates (if they're still there) or they can be redirected back once it's final:
Completed — "Tu reembolso fue exitoso": confirms the money was sent to their bank account.
Rejected / Failed — "No pudimos procesar tu reembolso": tells the payer the refund couldn't be completed and to request a new one directly with your business.
Both terminal screens keep the same Resumen/Detalle summary and a return-to-merchant button.

Status Reference#

What the payer seesUnderlying refund.status.state
Form screen (destination + consent)waiting_for_information
"Estamos procesando tu reembolso"processing
"Tu reembolso fue exitoso"completed
"No pudimos procesar tu reembolso"failed or rejected
Full field-level detail (status.code, status.description, webhook payloads) is documented in the Refund API guide's Refund Lifecycle section.

What to Tell Your Payer#

"Is this link safe?" Yes — it's generated and hosted by Cobre specifically for this refund, shows your business name, and never asks for banking credentials or passwords, only the destination account or Bre-B key to send the money to.
"The link says it's expired." The payer needs a new refund request from you — trigger a new refund and a fresh link will be generated.
"I confirmed my details but nothing happened." Check the refund's status on your side. If it's still processing, the payout is in flight; if rejected or failed, the payer's details may need to be resubmitted through a new refund request.
"I didn't get the verification code." Codes are sent to the masked email shown on screen. If it doesn't arrive, the payer can wait for the resend countdown to finish and request a new one. If the problem persists, please contact support.
Modified at 2026-11-11 00:11:24
Previous
Introduction & Quick Start
Next
Approval Process (Maker-Checker)
Built with