通过 Fedwire 付款

通过 Fedwire 的出款解决方案提供以下服务：从 Cobre Balance 或银行账户向持有有效美国银行账户的收款方汇出资金，使用美国的 Fedwire Funds Service 支付通道。

Fedwire 出款通常用于通过 ABA 路由号码和账户号码向美国银行账户即时发送大额资金，支持当日结算，为美国境内转账提供可靠的出款体验。

Fedwire 限制与路由行为

使用 Fedwire 通道的出款受到特定操作限制的约束。

通过 Fedwire 通道每笔交易允许的最低金额为 USD 1.00。Cobre 本身不设置单笔交易上限，但各银行可能有其自身限额。

Fedwire 在美联储的处理时间窗口内运行。在时间窗口外提交的交易将被排队，并在下一个可用结算周期内处理。对于时间敏感的出款，我们建议提前确认提交时机。

如果因通道不可用或银行限制导致出款无法通过 Fedwire 处理，Cobre 不会自动重新路由该交易。在此情况下，资金流动将转为 failed 状态，资金将退回至您的 Cobre Balance。

我们建议在提交前核验收款方的 ABA 路由号码和账户信息，以避免交易失败。

支持的交易对手方

通过 Fedwire 出款支持以下在美国的目标类型：

目标类型	交易对手方类型	通道
美国企业银行账户	`business`	Fedwire

授权工作流（可选）

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

出款生命周期

通过 Fedwire 的出款遵循简单的生命周期：

1. 创建美国银行账户交易对手方（收款方）
使用收款方的美国银行账户信息（包括 ABA 路由号码和账户号码）创建类型为 business 的交易对手方。
该交易对手方代表出款交易的目标账户。

2. 创建资金流动
创建资金流动时需提供：

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

上一步获取的 counterparty_id，用作 destination_id。

包含 description 的元数据。

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

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

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

Fedwire 截止时间

Fedwire Funds Service 在周一至周五运行，美国联邦法定假日除外。在每日截止时间后提交的交易将排队至下一个工作日处理。请联系支持团队获取当前截止时间安排。

收款方信息要求

Fedwire 出款需要有效的 ABA 路由号码（9 位数字）和美国银行账户号码。请在提交前核实收款方信息，以避免被收款银行拒绝。

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

如所有校验通过，状态变更为 processing。此时，交易已提交至 Fedwire Funds Service。

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

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

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

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

如果资金流动状态为 completed，收款方已成功收到资金。

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

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

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

🔑 Create

🔍 Retrieval

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

🔗 创建资金流动

资金流动幂等性

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

幂等键有效期为 24 小时。

如何开始

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

使用此 API 前

You need a Cobre Balance in the United States

如需通过 Fedwire 发送资金，您必须在美国拥有一个余额充足的有效 Cobre Balance 账户。

Create the beneficiary Counterparty

在创建出款资金流动之前，您必须先创建一个包含收款方美国银行账户信息（包括 ABA 路由号码和账户号码）的交易对手方。

Define the Payout configuration

确定目标类型、金额以及处理出款所需的任何元数据。确认交易将在 Fedwire 运营时间内提交。

Implement Webhooks to track payment status

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

详情请参阅通知与订阅。

使用此 API 后的预期结果

Initiate the Payout

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

Track the transaction status

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

Funds are delivered to the beneficiary

出款成功后，资金将入账至收款方的美国银行账户，资金流动状态也将相应更新。

通过 Fedwire 付款

Fedwire 限制与路由行为#

支持的交易对手方#

授权工作流（可选）#

出款生命周期#

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

资金流动幂等性#

如何开始#

使用此 API 前#

使用此 API 后的预期结果#

Fedwire 限制与路由行为

支持的交易对手方

授权工作流（可选）

出款生命周期

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

资金流动幂等性

如何开始

使用此 API 前

使用此 API 后的预期结果