外部付款

​

概览

• 向任何拥有美国银行账户的人付款。 收款方只需要路由号码和账号，无需注册 Fluz。
• 直接从你的 Fluz 余额付款。 资金来自账户的某个现金余额，因此无需单独的充值步骤。
• 可安全重试。 每笔付款都带有幂等键，因此网络重试绝不会重复转出资金。
• 费用一目了然。 响应会显示手续费以及从余额中扣除的总额。

1. 使用 createExternalPayee 将收款方的银行账户保存为收款人。
2. 使用收款人、来源现金余额和金额调用 createExternalPayout。
3. Fluz 会立即扣除现金余额，并返回状态为 PENDING 的付款。
4. 资金将在下一个标准 ACH 文件中发送到收款方的银行。

• createExternalPayout - 向外部收款人转账

​

createExternalPayout

​

变更（CreateExternalPayoutInput）

createExternalPayout(input: CreateExternalPayoutInput!): ExternalPayoutResult

​

输入

​

响应（ExternalPayoutResult）

​

示例

mutation {
  createExternalPayout(
    input: {
      idempotencyKey: "550e8400-e29b-41d4-a716-446655440020"
      externalPayeeId: "3f1c2b7e-8d4a-4c1e-9f2a-6b5d4e3c2a10"
      sourceCashBalanceId: "aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee"
      amount: 100.00
    }
  ) {
    transferId
    externalPayeeId
    amount
    fee
    totalDebited
    status
  }
}

{
  "data": {
    "createExternalPayout": {
      "transferId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "externalPayeeId": "3f1c2b7e-8d4a-4c1e-9f2a-6b5d4e3c2a10",
      "amount": 100,
      "fee": 1.5,
      "totalDebited": 101.5,
      "status": "PENDING"
    }
  }
}

{
  "errors": [
    {
      "message": "The sender does not have sufficient balance to complete this transfer.",
      "extensions": { "code": "PT-0007" }
    }
  ]
}

​

错误码

​

付款状态

​

重要说明

​

资金与时效

• 变更成功后，现金余额会立即扣除 totalDebited。
• 付款使用标准 ACH。不支持当日 ACH 和加急 ACH。
• 资金会在下一个 ACH 文件中离开 Fluz。到账所需时间取决于 ACH 处理以及收款方的银行。

​

费用与限额

• 手续费由 Fluz 设定，并在 amount 之外另行收取。收款方会收到完整的 amount。
• 每日、每周、每月和每年的限额，以及最低和最高金额，均按账户适用。达到限额时，请求会失败并返回 PT- 错误码。
• 仍在清算中的资金无法发送。

​

幂等性

• 每笔新付款都发送一个新的 UUID。
• 如果请求超时，请使用相同的键和相同的输入重试。你会得到原始结果，且资金不会被重复转出。
• 如果同一个键被用于不同的金额、来源余额或收款人，请求将被拒绝。
• 幂等键在所有转账类型之间共享。已用于其他类型转账的键不能在此处重复使用。

​

收款人

• 收款人必须在账户上处于激活状态。已移除的收款人无法收款。
• 部分银行账户无法接收付款。此时请求会失败并返回 ARG-0001。

​

被退回的付款

• 如果收款方的银行拒收该笔付款（例如账户已关闭），资金会退回到来源现金余额。