1. 其他功能
🇨🇳 中文(简体)
  • 🇺🇸 English
  • 🇪🇸 Español
  • 🇨🇳 中文(简体)
  • Cobre 简介
    • 欢迎
    • 快速入门
    • 将 Cobre 文档接入 AI
    • 产品
      • 本地支付
        • 使用 Cobre 进行本地支付
        • 收款
          • 哥伦比亚
            • 收银台
            • 请求支付
            • 通过 Nequi 进行直接扣款
            • 静态 Bre-B 密钥
            • 转入 (Transfer-In)
          • 墨西哥
            • 请求支付
            • 基于 CLABE 的虚拟余额账户
            • 虚拟 CLABEs
          • 美国
            • Fedwire 向 Cobre 付款
        • 出款
          • 哥伦比亚
            • 通过 Bre-B 进行资金流动
            • 通过 Cobre Fast Pay 进行资金流动
          • 墨西哥
            • 通过 CLABEs 和 SPEI 卡进行资金流动
          • 美国
            • 通过 Fedwire 进行资金流动
          • 多地区
            • 资金流动调度器
        • 其他功能
          • 批量资金流动
          • 启用审批工作流(双人复核)
      • 跨境支付
        • 通过 Cobre 进行跨境支付
      • 连接
        • 连接 Cobre 关联银行账户
      • 稳定币
        • 全球稳定币出款
    • 其他功能
      • 账户核验
      • 通知与订阅
      • Cobre 安全机制
      • 性能与吞吐量
    • 使用 Cobre
      • 使用您生态系统中的支付工具通过 Bre-B 进行出款
      • 面向贷款机构的 Cobre
      • 从 ERP 系统集成 Cobre
  • 网络门户
    • 简介与快速入门
    • 门户认证
    • 故障排查与支持
    • 资金流动
      • 审批流程(双人复核)
      • 本地资金流动
      • 单笔支付发起
      • 批量资金流动发起
      • 跨境资金流动
      • 支付链接
      • 调度程序
    • 交易
      • 交易
    • 账户
      • 账户与余额管理
      • 账户参考
        • 虚拟 CLABE
        • 转账账户(转入)
    • 交易对手方
      • 交易对手方
    • 报告
      • 报告与对账
    • 设置
      • 用户与角色管理
      • 安全与管控
    • 开发者
      • 订阅管理
  • 开发者
    • API 指南
      • 快速入门
      • 身份验证
      • Cobre Balances
        • 管理虚拟余额账户(Cobre Balances)
        • 账户关联
      • Connect 账户
        • 管理 Connect 账户
      • 交易对手方
        • 管理交易对手方
      • Local Payments
        • 资金流动
        • 出款
          • 哥伦比亚
            • Fast Pay & ACH
            • Bre-B
          • 墨西哥
            • SPEI
          • 跨地区
            • 批量资金流动审批
            • 资金流动调度器
            • 批量资金流动
          • 美国
            • 通过 Fedwire 付款
          • 全球
            • 稳定币全球出款
        • 收款
          • 哥伦比亚
            • Cobre Keys 与 Bre-B 集成
            • 收银台
            • Direct Link
            • Direct Debit
            • Transfer-In
            • 在哥伦比亚处理退款
          • 墨西哥
            • 账户参考 – 虚拟 CLABE
            • Direct Link
            • 在墨西哥处理退款
          • 美国
            • 通过 Fedwire 收款
      • 跨境支付
        • 跨境支付
        • 创建 FX 报价
        • 创建跨境资金流动
        • 为全球 Cobre Balance 注入资金
      • 通用功能
        • 账户核验
        • 使用 Cobre Reports 在哥伦比亚进行对账
        • 报告
        • 报告调度器
        • 证据 API
        • 通知与订阅
        • FX 汇率预警
      • 错误处理
        • 错误字典
      • 测试
        • 通用测试
        • 测试用例
        • 测试 PSE 与 Bancolombia
      • 认证
        • 认证流程
        • 问卷
    • API 浏览器
      • 借助 AI 进行开发
      • 身份验证 API
        • 身份验证
      • 账户
        • 创建或关联账户
        • 获取所有账户
        • 获取单个账户
        • 更新账户
        • 关闭 Cobre Balance
        • 查询单个账户的交易记录
        • 获取单笔交易
        • 获取所有交易记录
        • 获取账户每日余额历史记录
        • 分配或更换主账户
        • 解除主账户关联
      • 账户核验
        • 创建账户核验
        • 获取单条账户核验记录
        • 获取所有账户核验记录
      • 账户参考
        • 创建账户参考
        • 查询单个账户参考
        • 查询所有账户参考
        • 删除账户参考
        • 为账户参考生成证书
      • Cobre 密钥
        • 创建密钥
        • 获取所有 Keys
        • 获取单个 Key
        • 注销 Key
        • 封禁或重新激活 Keys
      • 交易对手方
        • 账户借记注册
          • 为 Direct Debit 注册交易对手方
          • 获取所有注册记录
          • 获取单条注册记录
        • 创建 Counterparty
        • 获取单个 Counterparty
        • 获取所有 Counterparties
        • 删除交易对手方
      • 资金流动
        • 创建资金流动
        • 查询单笔资金流动
        • 查询所有资金流动
        • 退回资金流动
      • 批量资金流动审批
        • 批量资金流动审批决策
      • 资金流动调度器
        • 创建资金流动调度器
        • 获取所有资金流动调度器列表
        • 取消活跃的调度器
      • 批量资金流动
        • 创建批量资金流动
        • 列出所有批量资金流动
        • 查询单条批量资金流动
      • 资金流动审批
        • 审批资金流动
        • 列出所有资金流动审批
      • 跨境支付
        • 创建 FX 报价
        • 获取单条 FX 报价
        • 获取全部 FX 报价
        • 创建跨境资金流动
        • 获取单条跨境资金流动
        • 获取所有跨境资金流动记录
      • 收银台
        • 创建 Checkout
        • 获取单个 Checkout
        • 获取所有 Checkout
        • 停用 Checkout
      • 证据 API
        • 证据请求
          • 获取证据请求
          • 搜索证据请求
        • 证据文件
          • 生成上传链接
          • 生成下载链接
        • 证据信息
          • 提交证据信息
      • 报告
        • 创建报告
        • 获取所有报告
        • 为所选报告生成下载链接
        • 创建 Cobre Balance 对账单
      • 报告调度器
        • 创建 Report Scheduler
        • 获取所有 Report Schedulers
        • 删除 Report Scheduler
      • 通知与订阅
        • 订阅事件
        • 获取所有订阅
        • 删除订阅
        • 列出所有可用事件
      • 预警
        • 创建预警
        • 获取所有预警
        • 获取单个预警
        • 停用告警
    • 平台目录
      • 墨西哥银行代码
      • 账户提供方
      • 交易类型
      • 资金流动状态
      • 哥伦比亚银行代码
    • API 测试
      • 创建交易调整
      • 更改资金流动状态
      • 交易调整(QA)
      • 变更资金流动状态(QA)
    • 报告布局
      • 资金流动布局
        • 所有资金流动 (CSV)
        • 所有资金流动 (JSON)
        • SPEI 资金流动 (CSV)
        • LEGACY 资金流动 (CSV)
      • 交易布局
        • 所有交易 (CSV)
        • 所有交易 (JSON)
        • 虚拟余额账户 (Cobre Balance) 对账单 (PDF)
      • 交易对手方布局
        • 所有交易对手方 (CSV)
      • Multicash 布局
        • Multicash 表头 (TXT)
        • Multicash 明细 (TXT)
    • 通知布局
      • 账户事件
        • 账户余额借记
        • 账户余额贷记
      • Cobre 密钥
        • Cobre 钥匙
      • 交易对手方
        • 交易对手方
      • 资金流动
        • 资金流动
      • 批量资金流动
        • 批量资金流动
      • 跨境资金流动
        • 跨境资金流动
      • 证据请求
        • 证据请求
      • 报告
        • 报告
      • 预警
        • FX 预警
      • 账户参考
        • 账户参考
  • Schemas
    • Counterparties
      • Colombia
        • PayOut
          • Counterparty | Create Metadata Type CC (CO)
          • Counterparty | Create Metadata Type CH (CO)
          • Counterparty | Create Metadata Type DP (CO)
          • Counterparty | Create Metadata Type Breb Key (CO)
          • Counterparty | Create Metadata Type Cobre Balance (CO)
          • Counterparty | Create Metadata Type QR (CO)
          • Counterparty | Response Metadata Type CC (CO)
          • Counterparty | Response Metadata Type CH (CO)
          • Counterparty | Response Metadata Type DP (CO)
          • Counterparty | Response Metadata Type Breb Key (CO)
          • Counterparty | Response Metadata Type Cobre Balance (CO)
          • Counterparty | Response Metadata Type QR (CO)
        • PayIn
          • Counterparty | Create Metadata Type r2p (CO)
          • Counterparty | Create Metadata Type r2p Breb (CO)
          • Counterparty | Response Metadata Type r2p (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 Request Metadata Type LE
          • Secondary Counterparty Response Metadata Type NP (CO)
          • Secondary Counterparty Response Metadata Type LE (CO)
        • Direct Debit
          • Direct Debit Registration | Response
          • Direct Debit Registration | List All Items
        • Counterparty | Create Request (CO)
        • Counterparty | Create Response (CO)
      • Mexico
        • PayOut
          • Counterparty | Response Metadata Type Clabe (MX)
          • Counterparty | Response Metadata Type SPEI Card (MX)
          • Counterparty | Create Metadata Type Clabe (MX)
          • Counterparty | Create Metadata Type SPEI Card (MX)
        • PayIn
          • Counterparty | Response Metadata Type r2p (MX)
          • Counterparty | Create Metadata Type r2p (MX)
        • Counterparty | Create Response (MX)
        • Counterparty | Create Request (MX)
        • Counterparty | Money Movement Return (MX)
      • Global
        • Counterparty | Global CP Request
        • Counterparty | Global CP Response
        • Counterparty | Global Deposit NP request
        • Counterparty | Global Deposit LE request
        • Counterparty | Global Deposit NP response
        • Counterparty | Global Deposit LE response
      • USA
        • Counterparty | Create Request (USA)
        • Counterparty | Create Response (USA)
        • Request Medatata Business
        • Request Medatata Individual
        • Response Medatata Business
        • Response Medatata Individual
      • Counterparty | List All Items
    • Transactions
      • Global
        • Transaction | Credit Cross Border
        • Transaction | Debit Cross Border
      • Colombia
        • Debit
          • Transaction | Debit FI (CO) (col_debit)
          • Transaction | Debit Cobre Balance (CO)
          • Transaction | Debit Breb (CO) (breb_debit)
        • Credit
          • Transaction | Credit FI (CO) (col_credit)
          • Transaction | Credit Cobre Balance (CO) (col_cb_credit)
          • Transaction | Credit r2p (r2p_credit)
          • Transaction | Credit Direct Debit (CO) (dd_credit)
          • Transaction | Rejected Breb (breb_rejected)
          • Transaction | Credit Breb (CO) (breb_credit)
          • Transaction | Credit r2p Breb (CO) (r2p_breb_credit)
          • Transaction | Credit Top Up (CO) (col_top_up_credit)
        • Transaction | Connect Obtain (CO)
        • Transaction | Cobre Balance Obtain (CO)
      • Mexico
        • Debit
          • Transaction | Debit SPEI (MX) (spei_debit)
          • Transaction | Debit FI (MX) (mex_debit)
          • Transaction | Debit Internal SPEI (MX)
        • Credit
          • Transaction | Credit SPEI (MX)
          • Transaction | Credit FI (MX)
          • Transaction | Credit Internal SPEI (MX)
        • Transaction | Connect Obtain (MX)
        • Transaction | Cobre Balance Obtain (MX)
        • Transaction | Return SPEI (MX)
      • Transactions | Cobre Balance List All Items
      • Transaction | Adjustment Credit
      • Transaction | Adjustment Debit
      • Transaction | Credit Misc
      • Transaction | Debit Misc
    • 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 | 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 | Create Metadata Type Bre-B
          • Money Movement | Create Metadata Type ACH
          • Money Movement | Response Metadata Type ACH
          • Money Movement | Response Metadata Type Fast Pay
          • Money Movement | Response Metadata Type Bre-B
          • Money Movement | Response Metadata Type Bre-B Split
        • PayIn
          • Money Movement Direct Link | Create Metadata Rail PSE
          • Money Movement Direct Link | Create Metadata Rail r2p Breb
          • Money Movement Direct Link | Response Metadata Rail r2p Breb
          • Money Movement Direct Link | Response Metadata Rail PSE
          • Money Movement Direct Link | Response Metadata Rail Bancolombia
          • Money Movement Direct Link | Response Metadata Rail Nequi
        • 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)
      • United States
        • PayOuts
          • Money Movement | Create Metadata Type Fedwire
          • Money Movement | Response Metadata Type Fedwire
      • Money Movement | List All Items
      • Money Movement | Create Response
    • Accounts
      • Account Verification
        • Mexico
          • Account Verification Create Metadata Type mex_acc_details_1
          • Account Verification Create Metadata Type mex_acc_ownership_1
          • Account Verification Response Metadata Type mex_acc_ownership_1
          • Account Verification Response Metadata Type mex_acc_details_1
        • Colombia
          • Account Verification Create Metadata Type col_key_details_1
          • Account Verification Create Metadata Type col_key_ownership_1
          • Account Verification Create Metadata Type col_key_ownership_2
          • Account Verification Response Metadata Type col_key_ownership_1
          • Account Verification Response Metadata Type col_key_details_1
        • Account Verification Create Response
        • Account Verifications List All Items
      • Account References
        • Account References Request
        • Account Reference Response
        • List all account references
        • 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 Response (MX)
          • Connect Account | Response Metadata (MX)
          • Cobre Balance | Create Metadata (MX)
          • Connect Account | Create Metadata (MX)
        • Colombia
          • Cobre Balance | Create Response (CO)
          • Connect Account | Response Metadata (CO)
          • Cobre Balance | Create Metadata (CO)
          • Connect Account | Create Metadata (CO)
        • Global
          • Cobre Balance | Create Response (Global)
          • Cobre Balance | Create Metadata (Global)
        • 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 | 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
        • Upload Intent Request
    • Cross Border
      • Cross Border Money Movement
        • Cross Border Money Movement Create Request
        • Cross Border Money Movement Obtain Response
        • Cross Border Money Movements List All Items
        • Cross Border Money Movement Create Response
      • FX Quote
        • FX Static Quote
          • FX Quote Rolling | Create Response
          • FX Quote Rolling | Cross Border Response
        • FX Rolling Quote
          • FX Quote Static | Create Response
          • FX Quote Static | Cross Border 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
      • Reports List All Items
      • Cobre Balance Statement Request
      • Cobre Balance Statement Response
      • Reports Create Metadata
    • Error Model
      • Error Model
    • Report Scheduler
      • Report Schedulers | Create Request
      • Report Schedulers | Delete Response
    • Alerts
      • Create Alert
      • Alert Object
      • List All Alerts
      • Alert | Metadata Type fx_rate
  1. 其他功能

通知与订阅

跨 Cobre 平台的实时可见性与事件驱动自动化#

Cobre 的通知与订阅(Notifications & Subscriptions)能力允许企业通过集中化的 Webhook 机制,实时接收关键平台事件的更新。客户无需依赖周期性轮询或人工监控,即可构建能够立即响应余额变动、支付状态、交易对手方、报告、凭证流程等变化的运营体系。
这一能力的价值在于显著提升运营效率、对账准确性和客户体验——尤其是在业务规模较大、跨多条支付通道和多个市场的场景下。

1. Cobre 通知与订阅能力概览#

借助通知与订阅功能,Cobre 使客户能够:
订阅跨多产品和服务的平台事件(账户、资金流动、跨境支付、批量处理、报告、凭证、Keys、交易对手方等)
在所选事件发生时,实时接收 Webhook 通知
为对账、风险预警、客户通知和运营工作流构建事件驱动自动化
通过跨所有已订阅功能的统一事件结构,标准化事件消费
通过启用签名通知提升安全性,帮助验证通知的真实性与完整性
通过重试机制应对瞬时投递失败,提高投递可靠性
从"主动查询状态"转向"响应事件",使集成扩展更具可预期性

2. 通知与订阅在 Cobre 体系中的定位#

通知与订阅是一个跨功能层,将 Cobre 的运营对象与客户系统相连接:
Cobre Balances 在余额被贷记或借记时生成事件,支持实时流动性监控和对账触发。
资金流动及相关流程(包括批量和跨境支付)生成反映生命周期和运营状态变化的事件,帮助客户及时响应支付完成、拒绝或内部状态流转。
交易可通过事件负载呈现,用于同步金融账簿或驱动报告流水线。
报告和凭证请求可发出事件,使团队能够自动化合规与对账流程。
在实践中,通知与订阅将 Cobre 转变为一个事件源,无需持续向 Cobre 查询更新,即可为客户的内部系统、运营工具和财务工作流提供数据支撑。

3. 核心能力与功能选项#

3.1 跨产品的集中化事件订阅#

Cobre 提供统一机制,用于订阅跨平台域的事件,包括:
账户
资金流动
批量资金流动
跨境资金流动
报告
凭证请求
Keys
交易对手方
这减少了功能碎片化:客户无需针对每条产品线采用不同的通知方案。

3.2 基于标准事件结构的 Webhook 通知#

所有通知均遵循统一的事件格式,通常包含:
事件标识符
事件键(表示发生了什么)
时间戳
事件专属内容负载
这种一致性使得跨不同事件类型构建共享处理流水线更加便捷。

3.3 签名通知——保障完整性与真实性#

对于有更高安全管控要求的客户,Cobre 支持签名通知,允许 Webhook 接收方验证:
通知来源的真实性
负载在传输过程中未被篡改
这对于运营受监管工作流、高交易量或高价值资金流动的客户尤为重要。

3.4 通过自动重试提升可靠性#

Cobre 对因连接问题导致的投递失败应用重试机制。
重试机制旨在提升韧性,同时避免在客户主动拒绝请求(例如返回 4xx 响应)的情况下产生不必要的重复投递。

3.5 规模化的事件驱动自动化#

通知可用于触发以下工作流:
对账任务
预警与监控
内部支付状态更新
与资金流动结果绑定的下游操作

4. 核心概念与术语#

订阅(Subscription):定义客户希望接收哪些事件类型以及投递目标地址的配置项。
事件(Event):表示 Cobre 平台中已发生事项(例如余额贷记、支付更新)的结构化通知。
事件键(Event Key):用于标识事件类型的标识符(用于对通知进行分类)。
Webhook:将通知实时发送至客户系统所使用的投递机制。
签名通知(Signed Notification):包含加密验证信号的通知,接收方可借此验证真实性与完整性。
重试机制(Retry Scheme):针对符合条件的失败(例如连接错误)的自动重新投递尝试。

5. 速度、结算与可靠性#

通知的设计目标是实现接近实时的运营感知,即事件在发生时立即投递,而非仅通过定时导出或周期性检查才能获取。
可靠性由以下机制保障:
连接错误的自动重试,在系统出现瞬时中断时提升投递成功率。
可选的签名通知,允许客户验证通知,从而提升信任度与可审计性。
最终性取决于所追踪的底层对象:
例如,"账户已贷记"事件反映已过账的余额变动,而"资金流动状态"事件则反映流程状态。

6. 典型业务使用场景#

常见使用场景包括:
余额变动时触发实时对账
面向客户支持或商户运营的支付状态自动化
基于交易或交易对手方相关事件的欺诈与风险监控
以事件负载为数据来源的内部账簿同步
运营预警(例如资金流动失败、凭证状态变更)
批量或跨境支付项目的工作流编排
该能力尤其适合处理高吞吐量、多条支付通道或多个市场业务的企业——在这些场景下,人工监控或轮询的成本高昂且响应迟缓。

7. 交易、报告与对账#

通知与订阅通过实时提供 Cobre 事件,提升对账效率,具体体现在:
将交易影响即时同步至内部账簿
为财资和财务团队自动捕获余额变动
在资金流动失败、被拒绝或需要运营介入时,更快速地处理异常
由于事件结构已标准化,财务团队可获得一致的元数据,从而跨产品线构建统一的对账流水线。

8. 治理、管控与可审计性#

通知与订阅通过以下方式支持治理:
可追溯性:每条通知均包含事件标识符和时间戳,支持审计追踪。
完整性管控:签名通知允许客户验证真实性并检测篡改行为。
运营韧性:重试机制降低了在短暂中断期间遗漏关键事件的风险。
这些管控措施使客户无需依赖人工检查,即可构建健壮的监控与合规工作流。

9. 通知与订阅 vs. 轮询 / 周期性状态检查#

维度通知与订阅轮询 / 周期性检查
更新时效实时推送延迟,取决于查询频率
运营负载较低(事件驱动)较高(持续查询)
可靠性方案对符合条件的失败进行重试客户须自行管理重试和数据缺口
安全选项支持签名通知通常不提供
适用场景高交易量、自动化、对账小规模、简单工作流
当客户需要实时运营、可扩展对账和更低集成开销时,通常优先选用通知与订阅方案。

10. 总结——Cobre 通知与订阅的核心价值#

Cobre 使客户能够:
订阅跨核心产品线的平台事件
通过标准化结构实时接收 Webhook 通知
为对账、监控和支付运营构建自动化工作流
通过签名通知完整性验证提升安全性
通过定义明确的重试机制增强投递韧性
通过将 Cobre 转变为事件驱动平台,通知与订阅帮助企业以更强的可见性、更快的响应速度和更优的财务管控,实现大规模支付运营。
Modified at 2026-06-12 23:18:07
Previous
账户核验
Next
Cobre 安全机制
Built with