Fast Pay & ACH

通过 Fast Pay / ACH 的 PayOuts 解决方案提供服务，可将资金从 Cobre Balance 发送至哥伦比亚的外部收款方，使用快速、近实时的支付通道。

Fast Pay / ACH PayOuts 通常用于高效地将资金划付至银行账户或其他 Cobre Balances，为企业和平台提供可靠且可扩展的付款体验。

Fast Pay 与 ACH 的区别

Fast Pay 是 Cobre 的专有付款解决方案，基于银行账户之间的直连通道构建，处理速度更快。

ACH 则是哥伦比亚的标准银行间转账系统。

两种通道的主要区别之一在于其服务级别协议（SLA），尤其是资金划转达到最终状态所需的时间。Fast Pay 与 ACH 之间的路由根据收款方所属银行自动确定，因为并非所有金融机构都支持 Fast Pay 解决方案。此路由行为不可由客户自行配置。

支持的交易对手方

通过 Fast Pay / ACH 进行的 PayOuts 支持以下哥伦比亚目的地类型：

目的地类型	交易对手方类型	通道
支票账户	`cc`	Fast Pay / ACH
储蓄账户	`ch`	Fast Pay / ACH
电子存款	`dp`	Fast Pay / ACH
Cobre Balance	`cobre_balance`	Fast Pay

如需查看哪些银行支持 Fast Pay 和/或 ACH，请参阅以下哥伦比亚银行代码。

授权工作流（可选）

审批人核准是一项可选解决方案，可在 PayOuts 流程中使用。它会在交易发送至支付网络之前触发授权工作流。在审批待处理期间，资金划转将保持 pending_approval 状态，直至被批准或拒绝。审批流程可通过 Cobre Portal 完成，也可通过 API 以编程方式完成。

PayOuts 生命周期

通过 Fast Pay 或 ACH 进行的 PayOuts 遵循简单的生命周期：

1. 创建交易对手方（收款方）
使用收款方信息创建一个交易对手方。
该交易对手方代表 PayOuts 交易的目的地。

2. 创建资金划转
使用以下信息创建资金划转：

作为 source_id 使用的 account_id，即扣款来源账户。

上一步骤中的 counterparty_id 作为 destination_id。

包含 description 的元数据。

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

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

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

3. 资金划转处理中
创建后，资金划转从 initiated 状态开始。

若所有校验通过，状态变更为 processing。此时，交易通过 Fast Pay 或 ACH 发送。

若校验或处理过程中发生错误，资金划转将转换为最终的 failed 状态。

若资金划转创建时设置了 checker_approval = true，则首先进入 pending_approval 状态，仅在做出审批决定后才会转换为 processing 或 canceled 状态。

4. 资金扣款
一旦资金划转转换为 processing 状态，资金将从关联的 Cobre Balance 中扣除。

5. 等待资金划转的最终结果。

若资金划转状态为 completed，则收款方已成功收到资金。

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

6. 接收状态更新
资金划转状态变更通过 Webhooks 进行通知。

资金划转（PayOuts）可执行的操作

🔑 Create

🔍 Retrieval

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

🔗 创建资金划转

资金划转幂等性

资金划转创建支持幂等性。

幂等键有效期为 24 小时。

如何开始

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

使用此 API 前

You need a Cobre Balance in Colombia

如需使用 Fast Pay / ACH 发送资金，您必须在哥伦比亚拥有一个余额充足的活跃 Cobre Balance 账户。

Create the beneficiary Counterparty

在创建 PayOuts 资金划转之前，您必须创建一个包含收款方信息的 Counterparty，并与所选目的地类型相匹配。

Define the Payout configuration

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

Implement Webhooks to track payment status

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

详情请参阅通知与订阅。

使用此 API 后的预期结果

Initiate the Payout

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

Track the transaction status

通过 Webhooks 或查询接口监控 PayOuts 生命周期。

Funds are delivered to the beneficiary

当 PayOuts 成功时，资金将入账至收款方账户，且资金划转状态将相应更新。

Fast Pay & ACH

Fast Pay 与 ACH 的区别#

支持的交易对手方#

授权工作流（可选）#

PayOuts 生命周期#

资金划转（PayOuts）可执行的操作#

资金划转幂等性#

如何开始#

使用此 API 前#

使用此 API 后的预期结果#