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

Direct Debit with Nequi

Direct Debit with Nequi for Collections is a Cobre capability that enables businesses to collect funds via Direct Debit by allowing payers to securely link their Nequi account once through a consent flow. After the payer approves the linking, businesses can initiate subsequent real-time debits without requiring payer confirmation for each transaction, reducing friction and improving conversion rates.
This feature is available through API and Portal, and is designed for recurring or repeat collections where a seamless pay-in experience is critical.

1. What Cobre Enables with Nequi Tokenization for Direct Debit Collections#

With this feature, Cobre enables businesses to:
Collect funds from Nequi accounts using a Direct Debit with Consent model
Perform a one-time account linking (tokenization) that authorizes future debits
Execute real-time debits without repeating the consent flow on every collection
Support collections from payers represented as counterparties (individual or business profile structures)
Track collection readiness through clear Direct Debit Registration statuses
Receive real-time operational updates through subscription events for registration lifecycle changes
Improve collection success rates and reduce drop-off for frequent payers

2. Nequi Tokenization in the Cobre Model#

Nequi tokenization fits into Cobre’s pay-ins ecosystem through three core building blocks:
Counterparties represent the payer and store the information needed to request authorization and collect funds.
Direct Debit Registrations (DDR) represent the payer’s consent and authorization to allow debits from their Nequi account.
Money Movements (Direct Debit) represent the actual debit collection initiated by the business once authorization is in place.
Cobre Balances are where collected funds are credited, and where businesses manage their liquidity.
Transactions provide the financial record of the collection outcome (e.g., credits posted to the balance after successful debits).
This model allows businesses to separate:
Authorization (one-time) from
Collection execution (repeatable, real-time)

3. Key Capabilities / Options#

3.1 One-Time Consent (Tokenization) for Nequi Accounts#

Cobre supports a secure linking flow where the payer receives a single push notification in the Nequi app to approve or reject being registered for direct debits.
Once approved, the payer becomes eligible for ongoing debits without re-approving each transaction.
Key behavior
Consent is captured once
Future debits do not require additional payer acceptance
Consent has a defined acceptance window

3.2 Direct Debit Registration (DDR) Lifecycle and Readiness#

Direct Debit Registration is the mechanism used to obtain authorization and manage payer eligibility.
Cobre provides clear DDR statuses, including:
Processing: registration is being processed and the payer’s institution is validating consent
Registered: payer is successfully authorized for direct debits
Unregistered: payer is not authorized (or registration was rejected/cancelled/expired)
Failed: registration failed and must be retried
These statuses help businesses determine if a payer is eligible for collections and enable operational decisioning.

3.3 Real-Time Direct Debit Collections Once Registered#

Once a payer is registered, businesses can initiate real-time debits using Direct Debit money movements.
Key characteristics:
Debits execute in real time
Payer does not need to re-approve each debit
Collections can be directed into any eligible Cobre Balance in Colombia
This provides a high-conversion pay-in option for businesses with frequent, repeat payers.

3.4 Registration Types (Nequi as the Current Available Option)#

Cobre supports registration types that determine which rail is used for debits.
Currently, the functional documentation describes Nequi Direct Debit as the available type.
Nequi Direct Debit characteristics include:
Works under Nequi rails
Requires payer confirmation in Nequi app
Registration acceptance window is time-bound
Debit processing is real-time
Enabled financial institution: Nequi

3.5 Operational Notifications via Subscription Events#

To support real-time operational workflows, clients can subscribe to lifecycle events tied to DDR updates.
Supported event themes include:
status processing
status registered
status unregistered
This is useful for:
updating internal payer eligibility status
triggering retries or fallback flows
monitoring onboarding conversion for payer linking

4. Core Concepts and Terminology#

Direct Debit with Consent: A direct debit model where the payer authorizes future debits through a consent flow.
Nequi Tokenization: The one-time linking of a Nequi account through payer approval, enabling future debits without re-approval.
Counterparty: The payer entity represented in Cobre, required for registration and debits.
DDR (Direct Debit Registration): The authorization record that confirms a counterparty can be debited.
Registration Status: The state indicating whether a payer is eligible for direct debits.
Direct Debit Money Movement: The execution of a debit collection after authorization is in place.
dd_credit transaction: The credit posted into a Cobre Balance after a successful direct debit collection.
Subscription Events: Notifications that allow businesses to track registration state changes in real time.

5. Speed, Settlement & Reliability#

Nequi direct debits are designed to support real-time collection execution once the payer is registered.
Operational timing is driven by two phases:
Registration phase:
Payers have up to 15 minutes to accept or reject the authorization request in Nequi.
Collection phase:
Once registered, debits are processed in real time.
Reliability is strengthened by:
standardized DDR states
subscription events to track status changes
explicit rejection/cancellation/expiration signals that reduce ambiguity and operational rework

6. Typical Business Use Cases#

This feature is well suited for:
Ride-hailing and mobility platforms collecting recurring charges
Subscription-based services and recurring billing models
Insurance and lending collections for repeat payers
Marketplaces collecting fees, commissions, or recurring seller charges
Utility-like businesses collecting periodic payments
Any business requiring high conversion and low-friction pay-ins
Nequi tokenization fits particularly well when businesses have repeat payers and want to avoid reintroducing approval friction for each payment attempt.

7. Transactions, Reporting & Reconciliation#

Nequi direct debit collections produce clear accounting outcomes:
Each collection is represented as a Direct Debit money movement
Successful collections result in a dd_credit transaction posted into the destination Cobre Balance
For finance and operations teams, this creates:
an auditable trail from authorization → collection → credit
structured reporting of successful collections through transactions
improved reconciliation, since balance credits are tied to direct debit outcomes
This is especially valuable for high-volume businesses that need predictable tracking for thousands of pay-ins per day.

8. Governance, Controls & Auditability#

Nequi Tokenization for Collections supports governance by enabling:
Clear eligibility gating: only registered counterparties can be debited
Traceability:
registration attempt history
registration status outcomes
money movement status tracking
Real-time monitoring via subscription events
Risk management through defined failure, rejection, cancellation, and expiration states
Businesses can apply internal control rules such as:
only collecting from payers with successful registration
requiring manual review if repeated failures occur
aligning collection attempts with customer consent and audit requirements

9. Summary — What Cobre Delivers with Nequi Tokenization for Direct Debit Collections#

Cobre enables businesses to:
Tokenize Nequi accounts through a one-time consent flow
Collect funds via Direct Debit with Consent without re-approval per debit
Execute real-time debits once counterparties are registered
Track readiness via DDR lifecycle states (processing, registered, unregistered, failed)
Receive real-time registration updates through subscription events
Reconcile collections through dd_credit transactions credited to Cobre Balances
Nequi Tokenization for Collections provides a scalable and low-friction way to run real-time direct debit pay-ins in Colombia, especially for businesses with recurring or repeat payer behavior.
Modified at 2026-01-21 01:56:45
Previous
Request to Pay (R2P)
Next
Static Bre-B Keys
Built with