支持的转账方向
转账必须包含当前 API Token 所代表的账户。系统不支持子账户到子账户的直接转账。如果需要将资金从一个子账户转到另一个子账户，请先从源子账户转回主账户，再从主账户转到目标子账户。
源账户和目标账户必须不同。两个账户都必须处于已激活状态，并且双方都必须启用 transfer 产品。
前置条件
创建转账前，请确认：- 当前认证账户是源账户或目标账户之一。
- 源账户和目标账户属于同一个主账户 / 子账户关系。
- 两个账户均已激活。如果涉及个人账户，该账户还必须完成验证。
- 两个账户均已启用 transfer 产品，并支持对应转账方向。
- 源账户有足够可用余额覆盖转账金额及可能产生的手续费。
- 你已获得双方的 account ID。对子账户，请使用 Account Center connected account API 返回的
account_id，而不是短展示 ID。 - 每次创建请求都使用唯一的
x-idempotency-key。
步骤1：检查源账户余额
使用 Retrieve Balance 或 List Balances 确认源账户有足够可用余额。IDR、JPY 等零小数币种，转账金额必须为整数。
步骤2：创建转账
调用 Create Transfer，传入源账户、目标账户、币种、金额和转账原因。transfer_id 用于 API 查询，short_reference_id 常用于运营、财务或客服沟通。
幂等性
Create Transfer 要求传入x-idempotency-key。请由你的系统生成 UUID，并且只在网络超时或连接中断后重试同一笔请求时复用该值。
如果使用同一个幂等键重试完全相同的请求体，UQPAY 会返回原始转账标识。如果同一个幂等键被用于不同请求体，请求会被拒绝。
推荐的重试方式：
- 仅在网络超时、连接重置或客户端无法确认结果时重试。
- 对同一笔转账的重试复用相同的
x-idempotency-key。 - 除非你确实要创建一笔新的转账，否则不要生成新的幂等键。
- 收到响应后，使用 Retrieve Transfer 确认最终状态。
步骤3：查询转账详情
使用 Retrieve Transfer 获取最新状态和转账详情。步骤4：列出转账用于对账
使用 List Transfers 对一段时间内的内部资金划转进行对账。page_size和page_numberstart_time和end_timetransfer_statuscurrency
transfer_id、short_reference_id、source_account_name、destination_account_name、transfer_amount 和 complete_time 匹配内部账务记录。