跳转到主要内容
账户到账户转账 通过 createTransfer 变更在两个 Fluz 账户之间转移资金。与内部转账不同 —— 内部转账是在你自己的消费账户之间转移资金 —— 账户到账户转账会把钱发送到一个不同的 Fluz 账户：你的某位用户、你的应用程序，或你的两个用户之间。 每笔转账都是两步流程：先识别收款人，然后创建转账。
与内部转账不同。若要在你自己的消费账户之间划转资金，请改用 内部资金划转。账户到账户转账用于将资金转移到一个单独的 Fluz 账户。

​
三种转账方向

同一个 createTransfer 变更支持三种方向。具体是哪一种由你的认证方式以及是否提供 destination 决定。
账户到账户转账需要公共应用。使用 Basic Auth（应用作为发送方）进行转账，要求你的应用为 ACTIVE 状态。个人应用无法通过 Basic Auth 发送。收款人也必须是你应用的注册用户。

​
第一步 — 查找收款人

在发送之前，使用查询接口将收款人解析为 accountId（二者均需要 QUERY_RECIPIENT scope）：
  • lookupUser —— 通过电话号码（E.164 格式）或电子邮箱查找个人。
  • lookupBusiness —— 通过公司名称查找企业（不区分大小写的精确匹配；会搜索注册名称和 DBA）。
如果你已保存了收款人的 Fluz accountId —— 或在创建时为其分配了 externalReferenceId —— 你可以跳过查询，直接在第二步传入该标识符。 参见 钱包转账收款人查询 以获取输入、响应和错误代码。

​
第二步 — 创建转账

使用 createTransfer 变更发送资金。至少需要提供 idempotencyKey 和 amount；destination 与资金来源取决于方向。
  • 识别收款人：通过 accountId 或你分配的 externalReferenceId 二选一提供。可选地，指定收款账户上的特定 userCashBalanceId。
  • 为转账提供资金：默认从发送方现金余额出资，或（仅限 Bearer token）从已关联的 bankCardId、bankAccountId 或 paypalVaultId 出资。每次请求仅允许一个资金来源。
  • 添加备注：可选地为转账添加 memo、transactionCategory 或 attachmentId。
Bearer token（用户发起）转账需要 MAKE_PAYOUT_TRANSFER_SEND scope。 参见 转账到另一 Fluz 账户 获取完整输入参考、各方向示例和错误处理。

​
幂等性

每笔转账都必须包含唯一、由客户端生成的 idempotencyKey。如果同一个键被多次提交，API 将返回最初请求的结果，而不会创建重复转账。键的有效期为 10 分钟。

​
一览要求

想了解更多？ 联系我们的专家以获取更多信息或申请演示。