1. Other features
  • Cobre Docs
    • 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)
              • Static Bre-B Keys
            • México
              • CLABE-backed 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
        • Local Money Movement
        • Unitary Payment Initiation
        • Bulk Money Movement Initiation
        • Approval Process (Maker-Checker)
        • Scheduler
        • Cross-Border Money Movements
        • Payment Links
      • Transactions
        • Transactions
      • Accounts
        • Account and Balance Management
      • 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 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
          • Reports
          • Report Scheduler
          • Evidence API
          • Account Verification
          • Notifications & Subscriptions
        • Error Handling
          • Error Dictionary
        • Testing
          • General Testing
          • Testing Cases
      • 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
          • Create an Account Verification
          • Obtail all Account Verifications
        • Account References
          • Create an Account Reference
          • List one Account Reference
          • List all Account References
          • Delete an Account References
        • 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
        • Cobre Keys
          • Create a Key
          • Obtain all Keys
          • Obtain one Key
          • Cancel a Key
          • Block or Reactivate Keys
        • 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
        • Report Scheduler
          • Create a Report Scheduler
          • Obtain all Reports Schedulers
          • Delete a Report Scheduler
        • Reports
          • Create a Report
          • Obtain all Reports
          • Generate Download Link for Selected Reports
          • Create a Cobre Balance Statement
        • 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
      • 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)
          • Cobre Balance Statement (PDF)
        • Counterparties Layout
          • All Counterparties (CSV)
        • Multicash Layout
          • Multicash Header (TXT)
          • Multicash Detail (TXT)
      • Testing APIs
        • Create a Transaction Adjustment
        • Change a Money Movement Status
        • Transaction Adjustment (QA)
        • Change Money Movement Status (QA)
    • 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
        • 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. Other features

Notifications and subcriptions

Real-time visibility and event-driven automation across the Cobre platform#

Cobre’s Notifications & Subscriptions capability allows organizations to receive real-time updates about key platform events through a centralized webhook-based mechanism. Instead of relying on periodic polling or manual monitoring, clients can build operations that respond immediately to changes in balances, payment status, counterparties, reports, evidence flows, and more.
This matters because it improves operational speed, reconciliation accuracy, and customer experience—especially at scale and across multiple payment rails and markets.

1. What Cobre Enables with Notifications & Subscriptions#

With Notifications & Subscriptions, Cobre enables clients to:
Subscribe to platform events across multiple products and services (Accounts, Money Movements, Cross-Border, Bulk, Reports, Evidence, Keys, Counterparties, etc.)
Receive real-time webhook notifications whenever selected events occur
Build event-driven automations for reconciliation, risk alerts, customer notifications, and operational workflows
Standardize event consumption using a consistent event schema across all subscribed features
Improve security by enabling signed notifications that help verify authenticity and integrity
Increase delivery reliability with a retry scheme for transient delivery failures
Scale integrations more predictably by shifting from “check status” to “react to events”

2. Notifications & Subscriptions in the Cobre Model#

Notifications & Subscriptions is a cross-feature layer that connects Cobre’s operational objects with client systems:
Cobre Balances generate events when balances are credited or debited, enabling real-time liquidity monitoring and reconciliation triggers.
Money Movements and related flows (including Bulk and Cross-Border) generate events that reflect lifecycle and operational state changes—helping clients react to payment completion, rejection, or internal status transitions.
Transactions can be reflected through event payloads and used to sync financial ledgers or power reporting pipelines.
Reports and Evidence Requests can emit events that allow teams to automate compliance and reconciliation processes.
In practice, Notifications & Subscriptions turns Cobre into an event source that can feed a client’s internal systems, operations tooling, and finance workflows without needing to constantly query Cobre for updates.

3. Key Capabilities / Options#

3.1 Centralized Event Subscription Across Products#

Cobre provides one unified mechanism to subscribe to events across platform domains, including:
Accounts
Money Movements
Bulk Money Movements
Cross-Border Money Movements
Reports
Evidence Requests
Keys
Counterparties
This reduces fragmentation: clients don’t need a different notification approach per product line.

3.2 Webhook Notifications with a Standard Event Schema#

All notifications follow a consistent event format, typically including:
An event identifier
An event key (what happened)
A timestamp
An event-specific content payload
This uniformity makes it easier to build shared processing pipelines across different event types.

3.3 Signed Notifications for Integrity and Authenticity#

For clients that require higher security controls, Cobre supports signed notifications, allowing webhook receivers to verify that:
The notification is genuine
The payload was not altered in transit
This is especially relevant for clients operating regulated workflows, high volumes, or high-value movements.

3.4 Reliability Through Automatic Retries#

Cobre applies a retry scheme for delivery failures caused by connection issues.
Retries are designed to improve resilience while avoiding unnecessary duplication in cases where clients intentionally reject requests (e.g., 4xx responses).

3.5 Event-Driven Automation at Scale#

Notifications can be used to trigger workflows such as:
reconciliation runs
alerting and monitoring
internal payment state updates
downstream actions tied to money movement results

4. Core Concepts and Terminology#

Subscription: A configuration that defines which event types a client wants to receive and where they should be delivered.
Event: A structured notification representing something that occurred in the Cobre platform (e.g., balance credited, payment updated).
Event Key: The identifier representing the type of event (used to classify notifications).
Webhook: The delivery mechanism used to send notifications to the client’s system in real time.
Signed Notification: A notification that includes cryptographic verification signals so the receiver can validate authenticity and integrity.
Retry Scheme: Automatic redelivery attempts for eligible failures (e.g., connection errors).

5. Speed, Settlement & Reliability (if applicable)#

Notifications are designed for near real-time operational awareness, meaning events are delivered as they occur rather than being available only through scheduled exports or periodic checks.
Reliability is supported by:
Automatic retries for connection errors, improving delivery success when systems experience transient downtime.
Optional signed notifications, which improve trust and auditability by allowing clients to validate the notification.
Finality depends on the underlying object being tracked:
For example, an “account credited” event reflects a posted balance change, while a “money movement status” event reflects a process state.

6. Typical Business Use Cases#

Common use cases include:
Real-time reconciliation triggers when balances change
Payment status automation for customer support or merchant operations
Fraud and risk monitoring based on transaction or counterparty-related events
Internal ledger synchronization using event payloads as the source of truth
Operational alerting (e.g., failed movements, evidence status changes)
Workflow orchestration for bulk or cross-border payment programs
This capability fits especially well for businesses handling high throughput, multiple rails, or multiple markets—where manual monitoring or polling becomes expensive and slow.

7. Transactions, Reporting & Reconciliation#

Notifications & Subscriptions improves reconciliation by making Cobre events available as they happen, enabling:
Immediate sync of transaction impacts into internal ledgers
Automated capture of balance changes for treasury and finance teams
Faster exception handling when movements fail, reject, or require operational attention
Because event structures are standardized, finance teams benefit from consistent metadata, allowing them to build unified reconciliation pipelines across product lines.

8. Governance, Controls & Auditability#

Notifications & Subscriptions supports governance through:
Traceability: every notification includes an event identifier and timestamp, enabling audit trails.
Integrity controls: signed notifications allow clients to verify authenticity and detect tampering.
Operational resilience: retry behavior reduces the risk of missing critical events during brief outages.
These controls allow clients to build robust monitoring and compliance workflows without relying on manual checks.

9. Notifications & Subscriptions vs Polling / Periodic Status Checks#

DimensionNotifications & SubscriptionsPolling / Periodic Checks
Update timingReal-time pushDelayed, depends on frequency
Operational workloadLower (event-driven)Higher (constant queries)
Reliability approachRetries for eligible failuresClient must manage retries and gaps
Security optionsSigned notifications availableTypically none
Best forHigh volume, automation, reconciliationSmall volume, simple workflows
Notifications & Subscriptions is usually preferred when clients need real-time operations, scalable reconciliation, and lower integration overhead.

10. Summary — What Cobre Delivers with Notifications & Subscriptions#

Cobre enables clients to:
Subscribe to platform events across key product lines
Receive real-time webhook notifications with a standardized schema
Build automation workflows for reconciliation, monitoring, and payment operations
Improve security with signed notification integrity validation
Increase delivery resilience through a defined retry scheme
By turning Cobre into an event-driven platform, Notifications & Subscriptions helps businesses operate payments at scale with stronger visibility, faster reactions, and better financial control.
Modified at 2026-01-08 23:45:06
Previous
Account Verification
Next
Security at Cobre
Built with