请求支付

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

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

R2P 尤其适合希望对支付流程拥有 最大灵活性和品牌掌控权 的企业。

1. Cobre 通过 Request to Pay 提供的能力

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

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

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

自主设计和控制 支付用户体验

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

将资金直接归集至 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 动态 QR 码（EMVCo）

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

客户端可生成可被银行 App 扫描的 QR 图像

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

示例：

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 字符串（以 QR 图像形式）

Cobre 提供 支付基础原语；商户负责设计支付旅程。

5. R2P 的概念性工作原理

从高层次视角来看：

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

Cobre 生成所需的支付凭证：

链接（PSE、Nequi、Bancolombia），或

动态 Bre-B Key / QR 字符串

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

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

资金划入商户的 Cobre Balance

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

整个流程 原生于银行体系，安全且完全可追溯。

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

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

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

Cobre 返回 支付链接

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

这支持自定义 UX 模式，例如：

嵌入式银行选择器

预选银行

特定国家的支付逻辑

7. 交易、报告与对账

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

划入企业/商户的 Cobre Balance

反映所选支付通道

显示在交易列表和余额对账单中

支持对账和财务工作流

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

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

R2P 尤其适用于：

自定义电商收银台

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

嵌入式金融产品

应用内支付

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

当 Checkout 过于受限 而需要定制化体验时，R2P 是理想选择。

9. 何时选择 R2P vs 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 和 QR 码
银行及钱包支付链接
完整的 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 动态 QR 码（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 vs 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 动态 QR 码（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 vs Checkout

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