SPEI

通过 SPEI 的 Payout 解决方案提供从墨西哥银行账户向墨西哥境内外部收款方发送资金的服务，使用 SPEI 实时支付网络。

SPEI Payouts 常用于高效地将资金拨付至银行账户或借记卡，为墨西哥市场提供快速、可靠且广泛采用的付款体验。

支持的交易对手方

通过 SPEI 的 PayOut 支持以下墨西哥境内目标类型：

目标类型	交易对手方类型	支付通道
CLABE 账户	`clabe`	SPEI
SPEI 卡	`spei_card`	SPEI

授权工作流（可选）

审批人审核是可在 Payout 流程中使用的可选方案。它在交易发送至支付网络之前触发授权工作流。在审批待处理期间，资金流动（Money Movement）保持 pending_approval 状态，直至被批准或拒绝。审批流程可通过 Cobre Portal 完成，也可通过 API 以编程方式完成。

Payout 生命周期

通过 SPEI 的 PayOut 遵循简单的生命周期：

1. 创建交易对手方（收款人）
使用收款人信息创建一个 Counterparty。
该交易对手方代表 SPEI Payout 交易的目标账户。

2. 创建资金流动
使用以下信息创建资金流动（Money Movement）：

资金将从中扣款的 account_id，用作 source_id。

上一步骤中的 counterparty_id 作为 destination_id。

包含 description 和 reference 的元数据。

external_id，可用于传递来自您系统的参考标识。

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

如需使用授权流程，将 checker_approval 设置为 true。

3. 资金流动处理中
创建后，资金流动以 initiated 状态启动。

若所有验证通过，状态变更为 processing。此时，交易通过 SPEI 发送。

若在验证或处理过程中发生错误，资金流动将转为最终的 failed 状态。

若资金流动创建时 checker_approval = true，则首先进入 pending_approval 状态，仅在审批决定作出后才会转为 processing 或 canceled。

4. 资金扣款
资金流动转为 processing 状态后，资金将从关联的 Cobre Balance 中扣除。

5. 等待资金流动的最终结果。

若资金流动状态为 completed，则收款人已成功收到资金。

若资金流动状态为 rejected，则资金将退回至您的 Cobre Balance。

6. 接收状态更新
资金流动状态变更通过 Webhooks 通知。

对资金流动（Payout）执行的操作

🔑 Create

🔍 Retrieval

描述： 创建资金流动。
执行操作后的预期结果： 资金流动在 Cobre 中创建完成。
📘 了解更多：

🔗 创建资金流动

资金流动幂等性

资金流动创建支持幂等性。

幂等键有效期为 24 小时。

如何开始

在开始之前，我们建议您查阅以下注意事项。

使用此 API 前

You need a Cobre Balance in Mexico

要使用 SPEI 发送资金，您必须在墨西哥拥有一个资金充足的有效 Cobre Balance 账户。

Create the beneficiary Counterparty

在创建 Payout 资金流动之前，您必须使用收款人信息创建一个 Counterparty，并与所选目标类型匹配。

Define the Payout configuration

确定目标类型、金额以及处理 Payout 所需的任何元数据。

Implement Webhooks to track payment status

为及时了解 Payout 交易的状态，我们强烈建议实现 Webhooks。Webhooks 可在付款发起、处理中、完成或失败时通知您的系统。同时订阅所需事件，以接收有关交易扣款和入账的通知。

请参阅通知与订阅了解更多详情。

使用此 API 后的预期结果

Initiate the Payout

资金流动创建请求发送后，将以 initiated 状态创建。
请确保您的系统已准备好接收资金流动在其生命周期中的状态更新。

Track the transaction status

通过 Webhooks 或查询接口端点监控 Payout 生命周期。

Funds are delivered to the beneficiary

Payout 成功后，资金将入账至收款人账户，资金流动状态将相应更新。

SPEI

支持的交易对手方#

授权工作流（可选）#

Payout 生命周期#

对资金流动（Payout）执行的操作#

资金流动幂等性#

如何开始#

使用此 API 前#

使用此 API 后的预期结果#