SPEI
支持的交易对手方
| 目标类型 | 交易 对手方类型 | 支付轨道 |
|---|---|---|
| CLABE 账户 | clabe | SPEI |
| SPEI 卡 | spei_card | SPEI |
授权工作流（可选）
pending_approval 状态，直至被批准或拒绝。审批流程可通过 Cobre 门户完成，也可通过 API 以编程方式完成。出款生命周期
使用收款方信息创建交易对手方。
该交易对手方代表 SPEI 出款交易的目标方。
使用以下信息创建资金流动：
account_id，用作 source_id。counterparty_id，用作 destination_id。description 和 reference 的元数据。external_id，可用于传递来自您系统的参考编号。创建后，资金流动从
initiated 状态开始。processing。此时，交易通过 SPEI 发送。failed 状态。checker_approval = true，则会先进入 pending_approval 状态，仅在作出审批决定后才会转换为 processing 或 canceled。一旦资金流动转换为
processing 状态，资金将从关联的 Cobre Balance 中扣除。completed，则收款方已成功收到资金。rejected，则资金将退回至您的 Cobre Balance。账户验证
资金流动状态变更通过 Webhooks 进行通知。
对资金流动（出款）执行的操作
🔑 Create
🔍 Retrieval
资金流动幂等性
幂等键的有效期为 24 小时。
如何开始
使用此 API 之前
You need a Cobre Balance in Mexico
如需通过 SPEI 发送资金，您必须在墨西哥拥有一个余额充足的有效 Cobre Balance 账户。
Create the beneficiary Counterparty
在创建出款资金流动之前，您必须使用收款方信息创建交易对手方，并与所选目标类型匹配。
Define the Payout configuration
确定目标类型、金额以及处理出款所需的任何元数据。
Implement Webhooks to track payment status
为及时掌握出款交易状态，我们强烈建议实现 Webhooks。Webhooks 会在付款发起、处理中、已完成或失败时通知您的系统。同时请订阅所需事件，以接收有关交易扣款和入账的通知。详情请参阅 通知与订阅。
使用此 API 后的预期结果
Initiate the Payout
资金流动创建请求发送后，将以 initiated 状态创建。
请确保您的系统已准备好在资金流动推进生命周期时接收状态更新。
请确保您的系统已准备好在资金流动推进生命周期时接收状态更新。
Track the transaction status
通过 Webhooks 或查询接口端点监控出款生命周期。
Funds are delivered to the beneficiary
出款成功后，资金将入账至收款方账户，资金流动状态随之更新。
Modified at 2026-06-12 23:18:07