Direct Link
所有面向用户的界面——包括支付方式选择、支付说明、确认页面及成功提示——均须由集成方自行完整开发和管理。
支持的支付方式
| 支付方式 | 通道 | 类型 | 有效期 |
|---|---|---|---|
| PSE | pse | 支付链接 | 10 分钟 |
| Bancolombia | bancolombia | 支付链接 | 10 分钟 |
| Nequi | nequi | 推送通知 | 15 分钟 |
| BreB QR | breb_qr | 二维码 | 5 分钟 |
| BreB Key | breb_key | Key | 5 分钟 |
交易对手方信息： 对于 pse，交易对手方中定义的电子邮件地址用于在 PSE 流程中验证用户身份。对于 nequi，交易对手方中定义的手机号码用于发送推送通知。
有效期因支付方式而异： 对于 pse，付款方最多有 10 分钟打开链接。链接打开后，最多有 25 分钟完成支付（具体时长可能因银行而异）。对于 bancolombia，付款方最多有 10 分钟打开链接。链接打开后，最多有 25 分钟完成支付。对于 nequi，付款方最多有 15 分钟通过推送通知accept（接受）或reject（拒绝）R2P 请求。对于 breb_key或breb_qr，您可以指定valid_until参数。建议的最短有效期为 5 分钟，最长为 7 天。
您可以设置账单描述符（与支付关联的说明），供付款方在收据中查看。请通过资金流动 API 中的 external_id字段进行设置。该功能暂不支持 Bre-B。
Bre-B 收款转账限额
Direct Link 生命周期
1.
使用付款方信息创建交易对手方。该交易对手方代表收款交易的资金来源方。
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
在创建资金流动之前，您必须先使用付款方信息创建交易对手方。
Define the payment configuration
确定可用的支付方式，以及向付款方展示的金额、有效期和参考信息。
Implement Webhooks to track payment status
为及时了解收款交易的状态，我们强烈建议实现 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-06-18 16:08:26