请求支付

由 API 驱动、商户自主掌控的支付体验

Request to Pay (R2P) 是 Cobre 提供的一项 纯 API 收款能力，允许企业在 完全掌控用户体验的同时发起收款请求。与提供托管支付流程的 Cobre Checkout 不同，R2P 使商户（或任何有收款需求的主体）能够自主设计和控制客户选择支付通道及完成支付的全流程，而 Cobre 则在底层负责编排原生银行支付请求。

R2P 尤其适合那些希望在支付旅程中实现 最大灵活性与品牌掌控力 的企业。

1. Cobre 通过 Request to Pay 实现的能力

借助 Request to Pay，Cobre 使企业能够：

通过 API 发起原生银行支付请求

使用与 Checkout 相同的本地支付通道

设计并掌控 自有支付用户体验（UX）

让用户自主选择 支付方式和银行

将资金直接归集至 Cobre Balances

通过 交易记录和报告 追踪请求与结果

R2P 将 Cobre 转变为一个 支付编排层，而非托管式收银台。

2. Request to Pay 支持的支付通道

Request to Pay 支持与 Checkout 相同的收款通道，确保产品间的一致性。

2.1 Bre-B 动态 Key

一次性 Bre-B Key

有时效限制，且金额固定

直接发送给付款方

授权后即时结算

示例：
@CBRNEM3SA49250014

2.2 Bre-B 动态二维码（EMVCo）

以 EMVCo 字符串 形式呈现的一次性二维码

客户端可生成可供银行 App 扫描的二维码图像

适用于面对面或视觉化支付场景

示例：

00020101021126320014CO.COM.CRB.LLA0410@CBRNEM3SA49250014CO.COM.CRB.RED0103CRB5
20400005303170540105802CO5918Pexto Colombia
SAS6006BOGOTA610611011185260014CO.COM.CRB.INC01040.0090560016CO.COM.CRB.TRXID01
32958b636a7d3e404585c0eda76d7689db91860014CO.COM.CRB.SEC0164a26ed16db9812eb18c4
adbae362b1c63c4f4f024e1ecf2f740fece847a0a7b0c80270016CO.COM.CRB.CANAL0103POS812
50015CO.COM.CRB.CIVA01020382260014CO.COM.CRB.IVA01040.0083270015CO.COM.CRB.BASE
01040.0084250015CO.COM.CRB.CINC0102036304FDA5

2.3 PSE

允许商户掌控银行选择体验

请求创建后，Cobre 返回 PSE 支付链接

用户被重定向至其所选银行以授权支付

完成后资金将记入商户的 Cobre Balance

Example

Cobre R2P link redirects to PSE directly

PSE load the seleccted bank experience and the payer access it to authorize the payment

2.4 Bancolombia 支付按钮

为 Bancolombia 用户生成 支付链接

将客户重定向至 Bancolombia 的授权流程

熟悉的原生银行体验

Example

Cobre R2P 链接直接跳转至 Bancolombia，付款方访问后即可授权支付。

2.4 Nequi 支付按钮

为 Nequi 用户生成 推送通知 和 支付请求

钱包原生授权体验

专为移动端优先用户优化

Example

这些支付通道使商户能够在单一自定义流程中提供 多种支付选项。

3. Request to Pay 的 Webhook 通知

Cobre 的 Request to Pay 支持 Webhook 通知，使企业能够实时接收支付请求状态的 实时更新。这使商户无需轮询或人工查询，即可立即响应支付事件。

Webhook 的核心价值

借助 Webhook，商户可以：

在支付 成功完成 时接收通知

获知 失败、已过期或已取消 的请求

自动更新订单或发票状态

触发下游流程，例如：

订单履行

服务激活

收据生成

内部对账

Webhook 将支付事件转化为商户系统的 可执行信号。

事件驱动的支付状态更新

每笔 Request to Pay 都有其生命周期，Webhook 事件反映该生命周期中的关键状态变化，例如：

支付状态

Processing（处理中）= 等待用户付款

Completed（已完成）= 支付已确认

Rejected（已拒绝）= 支付链接已过期或被放弃

Failed（失败）= 技术异常

这确保商户始终能 近实时地 掌握支付结果。

Webhook 在 R2P 流程中的位置

概念上：

商户通过 API 创建 Request to Pay

客户通过所选支付通道完成支付

Cobre 处理并结算支付

Webhook 事件被发送 至商户配置的接口端点

商户系统消费该事件并采取相应行动

该模型支持 异步、可扩展的支付处理。

4. 掌控支付体验

R2P 的核心差异化优势在于 完整的 UX 自主权。

借助 R2P，商户可以：

构建自有支付选择界面

允许用户自主选择：

支付通道

银行或钱包（适用时）

自主决定何时、以何种方式呈现：

支付链接（PSE、Nequi、Bancolombia）

Bre-B Keys

Bre-B EMVCo 字符串（作为二维码图像）

Cobre 提供 支付原语；商户自主设计支付旅程。

5. R2P 的概念性工作原理

从高层视角来看：

企业/商户通过 API 创建支付请求

Cobre 生成所需的支付凭证：

支付链接（PSE、Nequi、Bancolombia），或

动态 Bre-B Key / 二维码字符串

企业/商户将该凭证呈现给用户

用户通过其银行或钱包授权支付

资金记入商户的 Cobre Balance

交易记录和状态通过 Webhook 通知，并可用于追踪和对账

整个流程 基于原生银行机制，安全可靠，全程可追溯。

6. PSE 与银行选择（适用场景）

对于涉及 银行选择的支付通道（例如 PSE）：

企业/商户控制用户选择银行的方式

Cobre 返回 支付链接

用户被重定向至其银行进行授权

这使自定义 UX 模式成为可能，例如：

嵌入式银行选择器

预设银行

特定国家的支付逻辑

7. 交易记录、报告与对账

每笔成功的 R2P 支付都会在 Cobre 中生成 交易记录，该记录将：

将资金记入企业/商户的 Cobre Balance

反映所选支付通道

出现在交易列表和余额对账单中

支持对账和财务工作流

失败、已过期或已取消的请求同样会被追踪，以实现完整的生命周期可见性。

8. Request to Pay 的典型使用场景

R2P 尤其适用于：

自定义电商收银台

具有定制支付流程的平台/市场

嵌入式金融产品

应用内支付

全渠道体验（网页端、移动端、线下门店）

当 Checkout 灵活性不足 且需要定制化体验时，R2P 是理想选择。

9. 如何在 R2P 与 Checkout 之间做选择

选择 Checkout 的场景：

希望以最快速度完成集成

托管流程已能满足需求

UX 定制化非关键需求

选择 Request to Pay 的场景：

需要对 UX 拥有完全控制权

希望设计自定义支付逻辑

正在构建差异化产品

两种方案可在同一业务中并存。

虽然 R2P 与 Checkout 共用相同的底层支付基础设施，但两者的区别在于 谁来掌控体验。

维度	Checkout	Request to Pay (R2P)
接入方式	托管	纯 API
UX 归属	Cobre	客户端
界面/流程	预置	完全自定义
支付通道	相同	相同
上线速度	更快	更灵活
最适合	简单集成	自定义产品

Checkout 优先考虑简洁性，而 R2P 则优先考虑 掌控力与定制化。

10. 总结 — Cobre 通过 Request to Pay 提供的能力

借助 Request to Pay，Cobre 实现了：

纯 API、企业/商户自主掌控的支付流程
与 Checkout 相同的本地支付通道
动态 Bre-B Keys 和二维码
银行与钱包支付链接
完整的 UX 灵活性与掌控力
统一的交易记录与对账能力

Cobre Request to Pay 赋能企业构建 定制化、原生银行级支付体验，同时依托 Cobre 完成编排、安全保障和结算。

请求支付

由 API 驱动、商户自主掌控的支付体验#

1. Cobre 通过 Request to Pay 实现的能力#

2. Request to Pay 支持的支付通道#

2.1 Bre-B 动态 Key#

2.2 Bre-B 动态二维码（EMVCo）#

2.3 PSE#

2.4 Bancolombia 支付按钮#

2.4 Nequi 支付按钮#

3. Request to Pay 的 Webhook 通知#

Webhook 的核心价值#

事件驱动的支付状态更新#

Webhook 在 R2P 流程中的位置#

4. 掌控支付体验#

5. R2P 的概念性工作原理#

6. PSE 与银行选择（适用场景）#

7. 交易记录、报告与对账#

8. Request to Pay 的典型使用场景#

9. 如何在 R2P 与 Checkout 之间做选择#

10. 总结 — Cobre 通过 Request to Pay 提供的能力#

由 API 驱动、商户自主掌控的支付体验

1. Cobre 通过 Request to Pay 实现的能力

2. Request to Pay 支持的支付通道

2.1 Bre-B 动态 Key

2.2 Bre-B 动态二维码（EMVCo）

2.3 PSE

2.4 Bancolombia 支付按钮

2.4 Nequi 支付按钮

3. Request to Pay 的 Webhook 通知

Webhook 的核心价值

事件驱动的支付状态更新

Webhook 在 R2P 流程中的位置

4. 掌控支付体验

5. R2P 的概念性工作原理

6. PSE 与银行选择（适用场景）

7. 交易记录、报告与对账

8. Request to Pay 的典型使用场景

9. 如何在 R2P 与 Checkout 之间做选择

10. 总结 — Cobre 通过 Request to Pay 提供的能力