Direct Link
所有面向用户的页面——包括支付方式选择、支付说明、确认页面及成功提示——均须由集成方自行完整开发和管理。
支持的支付方式
| 支付方式 | 通道 | 类型 | 过期时间 |
|---|---|---|---|
| PSE | pse | 支付链接 | 10 分钟 |
| Bancolombia | bancolombia | 支付链接 | 10 分钟 |
| Nequi | nequi | 推送通知 | 15 分钟 |
| BreB QR | breb_qr | 二维码 | 5 分钟 |
| BreB Key | breb_key | 密钥 | 5 分钟 |
交易对手方信息： 对于 pse，交易对手方中定义的电子邮件地址用于在 PSE 流程中验证用户身份。对于 nequi，交易对手方中定义的手机号码用于发送推送通知。
过期时间因支付方式而异： 对于 pse，付款方最多有 10 分钟打开链接。链接打开后，最多有 25 分钟完成支付（具体时间可能因银行而异）。对于 bancolombia，付款方最多有 10 分钟打开链接。链接打开后，最多有 25 分钟完成支付。对于 nequi，付款方最多有 15 分钟通过推送通知accept（接受）或reject（拒绝）R2P 请求。
您可以为付款方设置账单描述符（与支付关联的说明），使其显示在收据中。请在资金流动 API 的 external_id字段中进行设置。该功能暂不支持 Bre-B。
Direct Link 生命周期
1.
使用付款方信息创建交易对手方。该交易对手方代表 PayIn 交易的资金来源。
2.
使用以下信息创建资金流动：
counterparty_id 作为 source_idaccount_id 作为 destination_idr2p_rail3.
获取资金流动信息，并按相应方式向用户提供操作指引：
4.
等待用户完成支付，并显示确认或成功页面。
5.
资金流动状态变更通过 Webhooks 通知。
6.
支付成功后，资金将划入关联的 Cobre Balance。
对资金流动（Direct Link）可执行的操作
🔑 Create
🔍 Retrieval
Direct Link 幂等性
幂等键的有效期为 24 小时。
如何开始
使用此 API 前的准备
You need a Cobre Balance in Colombia
要能够接收资金，您必须在哥伦比亚拥有一个 Cobre Balance 账户。
Create the Counterparty
在创建资金流动之前，您必须先使用付款方信息创建交易对手方（Counterparty）。
Define the payment configuration
确定可用的支付方式，以及向付款方展示的金额、有效期和参考信息。
Implement Webhooks to track payment status
为及时了解 PayIn 交易状态，我们强烈建议您实现 Webhooks。Webhooks 会在支付发起、处理中、完成或失败时通知您的系统。同时，请订阅所需事件以接收交易入账通知。详情请参阅 通知与订阅。
使用此 API 后的预期结果
Share the instructions
创建完成后，请根据所选支付方式向终端用户提供相应的支付操作指引。这可能包括将用户重定向至支付链接、告知用户即将收到推送通知，或显示 Bre-B Key 或二维码以完成支付。
End user completes the payment
付款方通过托管体验完成交易。
Receive funds in your Cobre Balance
支付成功后，资金将划入您的 Cobre Balance，同时对应资金流动记录将更新。
Modified at 2026-05-20 21:31:19