sendMoney 从用户的 Fluz 现金余额发送资金。你可以将资金发送到电子邮箱或手机号、Fluz 账户 ID，也可以不指定收款人，这时你会得到一个领取链接，由你自行转交。收款人无需是你应用的用户，也无需已有 Fluz 账户。
一笔汇款有两种结果。SENT 表示资金已进入收款人的余额，这是最终结果。PENDING_CLAIM 表示 Fluz 保管这笔资金，直到收款人在 Fluz 页面上领取。如果到期前无人领取，或你取消了汇款，资金会退回发送方。你指定收款人的方式决定了出现哪种结果。
开始之前
- 调用时请使用具有
MAKE_PAYOUT_TRANSFER_SEND权限范围的 Bearer 用户访问令牌。不接受使用 API 密钥的 Basic Auth。 - 令牌所属用户必须是该账户的所有者或管理员。
- Fluz 按账户开通发送资金功能。请联系你的客户经理，为每个需要发送资金的账户开通。
- 账户必须已通过身份验证：个人账户为 KYC，企业账户为 KYB。
- 如果用户将你的应用限制为只能使用某些消费账户，请从其中一个账户发送。
与
createTransfer 不同。createTransfer 在你的应用账户与已授权你的应用的账户之间移动资金，也可以在两个这样的账户之间移动资金。sendMoney 可以向任何能够接收付款的 Fluz 账户付款，也可以通过电子邮箱或手机号联系到对方。对于新收款人，它会保管这笔资金直到对方领取，并由 Fluz 向对方发送领取链接。汇款如何送达
Fluz 会匹配用户 Fluz 资料中的电子邮箱和手机号。如果其中任何一个匹配到多个用户，汇款会被拒绝，你需要改用其他标识。
你可以为同一个人同时传入
recipientEmail 和 recipientPhone。如果两者匹配到同一个用户，以手机号为准：只有该用户已验证手机号，资金才会立即转入其账户。如果两者匹配到两个不同的用户，Fluz 不会择一，而是保管资金。如果只有其中一个匹配到用户，则由该联系方式单独决定：只要用户已验证它，即使另一个联系方式没有匹配到任何人，资金也会立即转入该用户的账户。
recipientId 不能与电子邮箱或手机号同时使用，linkOnly 不能与任何收款人同时使用。不能向发送方自己的账户汇款。
如果汇款本应立即到账却无法到账，例如收款人的账户无法接收付款，或金额超出限额，汇款会失败并返回错误。Fluz 不会改为保管这笔资金。
发送资金
同一个变更涵盖所有类型的汇款，只有输入不同。Mutation
发送到电子邮箱或手机号
claimLink 是指向领取页面的短链接。请原样使用返回的链接，不要自行拼接或解析。
要发送到手机号，请传入 E.164 格式的 recipientPhone（例如 +14155551234），而不是 recipientEmail。
发送到 Fluz 账户
传入收款人的账户 ID。汇款要么立即到账，要么被拒绝。Variables
以领取链接发送
设置linkOnly，并自行转交 claimLink，例如放在你自己的应用或消息中。
Variables
输入字段
SendMoneyInput
指定汇款对象时，可以使用
recipientEmail、recipientPhone 或两者同时使用，也可以使用 recipientId 或 linkOnly。
对于待领取的汇款，备注会显示在领取页面上，任何打开链接的人都能看到，即使汇款已被领取或退回也是如此。请不要在备注中写入个人信息。
响应字段
SendMoneyResponse
收款人需要做什么
领取在 Fluz 页面上完成，而不是通过 API。1
打开链接
Fluz 会把领取链接发送到你汇款所用的电子邮箱或手机号。对于仅链接汇款，由你转交链接。
2
登录或创建 Fluz 账户
资金会转入收款人领取时所登录的账户，个人账户或企业账户均可。
3
验证身份
账户必须通过身份验证：个人账户需通过 KYC，企业账户需通过 KYB，并且账户能够接收付款。
4
证明联系方式
对于发送到手机号的汇款，收款人 Fluz 账户上的手机号必须与之匹配且已验证。对于发送到电子邮箱的汇款，Fluz 会向该邮箱发送一个 6 位验证码。如果你同时填写了两者，已验证且匹配的手机号就足够了；如果收款人账户上的手机号匹配但尚未验证，需要先完成验证；否则，收款人需要输入邮箱验证码。仅链接汇款只需要链接。
追踪待领取的汇款
要查看待领取汇款的当前状态，请使用相同的idempotencyKey 和相同的输入再次调用 sendMoney。响应会重复原始结果和各个 ID，并附上当前的 claimStatus，仅在 claimStatus 为 PENDING 时包含 claimLink，且不会移动任何资金。
重复调用会执行与新汇款相同的权限范围、角色和消费账户检查，因此如果该用户不再是所有者或管理员，或你的应用不能再使用该消费账户，调用会被拒绝。
取消待领取的汇款
cancelMoneySend 可在汇款的 claimStatus 为 PENDING 时将其取消，并把资金退回其来源的现金余额。状态为 SENT 的汇款无法取消。
Mutation
cancelled 始终为 true。同一用户在 24 小时内对同一笔汇款使用相同的 idempotencyKey 重复一次已成功的取消，会返回相同的响应。被拒绝的取消不会被保存，因此重复请求会重新执行。
到期
待领取的汇款可以领取到发送日之后第daysUntilExpiration 天的东部时间当天结束。响应中不包含该日期，因此请在发送时自行记录。
此后领取会被拒绝，Fluz 会在次日早上将资金退回发送方的现金余额，由每天东部时间 9:00 运行的任务执行。在资金退回之前，claimStatus 仍显示为 PENDING，你仍然可以取消这笔汇款。
幂等性
sendMoney 和 cancelMoneySend 都接受 idempotencyKey，这是一个由你生成的 UUID。不区分大小写。
- 使用相同的幂等键和相同的输入重复调用，会返回原来的汇款，不会移动任何资金，并显示汇款的当前状态。
- 幂等键会一直与其对应的汇款绑定。Fluz 在 24 小时内从缓存中响应重复请求，之后则根据汇款本身响应，因此同一个幂等键绝不会发送两次。每笔新汇款请使用新的幂等键。
- 如果重复调用更改了金额、现金余额或收款人，或对一个已用于指定收款人的幂等键设置了
linkOnly，会被拒绝并返回ARG-0001。不要复用其他操作的幂等键：用于createTransfer的幂等键会创建一笔新的汇款，用于对外打款的幂等键只有在该打款的幂等键为小写时才会被拒绝。 memo和daysUntilExpiration不参与比对。只更改这两项的重复调用，会原样返回原来的汇款。sendMoney的幂等键归账户所有，而不是归你的应用所有。该账户下的另一个应用或用户使用相同的幂等键和输入，会返回原来的汇款。- 如果汇款在任何资金移动之前就失败了，例如因为余额不足，该幂等键仍可使用。排除原因后，可以用相同的幂等键重试。
G-0409 表示 Fluz 仍在处理该幂等键，或其结果已丢失。汇款可能已经成功，因此请使用相同的幂等键和相同的输入重试，直到得到结果。处理中的请求最多会占用其幂等键 10 分钟。
限额
汇款会计入账户的转账限额：每日、每周、每月和每年的总额，以及单笔汇款的最小和最大金额。待领取的汇款从发送时起一直计入，直到资金退回。收款人的接收限额在资金到账时生效：立即到账的汇款在发送时生效，待领取的汇款在领取时生效。你账户的具体限额，请向你的客户经理咨询。错误
错误会出现在 GraphQL 的errors 数组中，此时 sendMoney 或 cancelMoneySend 为 null。请根据 extensions.code 区分处理。ARG- 和 G-0003 的消息会说明具体原因，其他消息可能会变化。
立即到账的汇款还会经过 Fluz 的欺诈筛查，筛查可能以其他错误码拒绝该汇款。对于发送到
recipientEmail 或 recipientPhone 的汇款，FLUZ- 限额错误码也可能表示收款人的接收限额。
缺失、无效或已撤销的令牌会在操作执行前被拒绝，返回 HTTP 401；已过期的令牌返回 HTTP 498。这两种响应都不包含 GraphQL errors 数组。
对于 cancelMoneySend：