Direct Link

Direct Link 提供服务，用于生成一次性虚拟 CLABE 账户，允许终端用户通过支持的即时支付方式将资金直接发送至 Cobre Balance。

Direct Links 通常用于按需收款，为企业和平台提供简单灵活的 PayIn 体验。

所有面向用户的界面——包括支付方式选择、支付说明、确认页面及成功提示——必须由集成方完整开发和管理。

支持的支付方式

Direct Link 支持以下在墨西哥进行 PayIn 操作的支付方式：

支付方式	支付轨道	类型	默认过期时间
Virtual Clabe	`spei`	虚拟 CLABE 账户	5 分钟

您可以通过 API 使用 valid_until 参数配置过期时间，最长可设置为 7 天。

请联系您的 KAM 以启用此功能

Direct Link 生命周期

Direct Link 遵循简单的生命周期：

创建类型为 r2p_spei 的 Counterparty
使用付款方信息创建 Counterparty。该 Counterparty 代表 PayIn 交易的资金来源。

创建 Money Movement
使用以下信息创建 Money Movement：

将上一步获得的 counterparty_id 作为 source_id

将您希望接收资金的 account_id 作为 destination_id

account_id 必须为 pr_mex_cobre3 账户。

为该支付轨道定义的 metadata。

以货币最小单位表示的金额（例如，100.00 MXN 应表示为 10000）。

引导用户完成支付流程
获取 Money Movement 信息，并向用户展示相应的操作说明：

显示虚拟 CLABE 账户。

用户完成支付
等待用户完成支付，并显示确认或成功页面。

接收状态更新
Money Movement 的状态变更将通过 Webhooks 进行通知。

资金入账
支付成功后，资金将记入关联的 Cobre Balance。

针对 Money Movement 可执行的操作（Direct Link）

🔑 Create

🔍 Retrieval

说明： 创建 Money Movement。
执行操作后的预期结果： Money Movement 在 Cobre 中创建成功。
📘 了解更多：

🔗 创建 Money Movement

Direct Link 幂等性

Money Movement 的创建支持幂等性。

幂等键的有效期为 24 小时。

如何开始

在开始之前，我们建议您先了解以下注意事项。

使用此 API 之前

You need a Cobre Balance in Mexico

要能够收款，您必须在墨西哥拥有一个 Provider 为 pr_mex_cobre3 的 Cobre Balance 账户。

Create the Counterparty

在创建 Money Movement 之前，您必须使用付款方的信息创建相应的 Counterparty。

Define the payment configuration

填写金额及有效截止日期

Implement Webhooks to track payment status

为及时掌握 PayIn 交易的状态，我们强烈建议您实现 Webhooks。Webhooks 可在支付发起、处理、完成或失败时通知您的系统。请同时订阅所需事件，以接收交易入账通知。

详情请参阅通知与订阅。

使用此 API 后的预期结果

Share the instructions

创建完成后，向您的终端用户提供相应的支付说明以及所生成的动态虚拟 CLABE 账户。

End user completes the payment

付款方通过托管体验完成交易。

Receive funds in your Cobre Balance

支付成功后，资金将记入您的 Cobre Balance，相应的 Money Movement 状态也将随之更新。

Direct Link

支持的支付方式#

Direct Link 生命周期#

针对 Money Movement 可执行的操作（Direct Link）#

Direct Link 幂等性#

如何开始#

使用此 API 之前#

使用此 API 后的预期结果#

支持的支付方式

Direct Link 生命周期

针对 Money Movement 可执行的操作（Direct Link）

Direct Link 幂等性

如何开始

使用此 API 之前

使用此 API 后的预期结果