代付钱包余额划转接口

1.请求地址（POST）

实时 API: https://api.futurepay.global/api/v1/payout/transfer

沙盒 API: https://api.futurepay-develop.com/api/v1/payout/transfer

认证方式：Bearer Token（需在Header中携带Authorization）

请求参数

请求参数说明

参数名	类型	是否必填	说明
currency	String	是	划转币种，3 位币种码，如 `CNY`
amount	BigDecimal	是	划转金额，必须 ≥ 1
fromAccount	String	是	转出钱包：`availableBalance`（可用余额） / `payOutBalance`（代付余额）
toAccount	String	是	转入钱包：`availableBalance`（可用余额） / `payOutBalance`（代付余额）
transferRemark	String	是	划转备注，最大长度 255
clientIp	String	是	客户端IP地址

⚠️
fromAccount 与 toAccount 不允许相同

请求示例（CNY）

{
    "transferRemark": "transfer available balance to payout balance",
    "amount": 1000,
    "toAccount": "payOutBalance",
    "clientIp": "47.86.10.42",
    "fromAccount": "availableBalance",
    "currency": "CNY"
}

响应参数（成功）

响应参数说明

参数名	类型	说明
voucherNo	String	划转凭证号
currency	String	币种
amount	BigDecimal	划转金额
fromAccount	String	转出账户
toAccount	String	转入账户
resultCode	String	划转状态：`SUCCEED` / `FAILED`
failReason	String	失败原因说明（成功时可能为空）

成功响应示例

{
  "code": "0",
  "msg": "SUCCESS",
  "success": true,
  "serverTime": 1766742432795,
  "data": {
    "voucherNo": "BT2025082600012345",
    "currency": "CNY",
    "amount": 1000,
    "fromAccount": "availableBalance",
    "toAccount": "payOutBalance",
    "resultCode": "SUCCEED",
    "failReason": ""
  }
}

API响应错误内容

当请求校验失败、余额不足、系统异常等情况时，接口将返回失败响应。

字段名	类型	描述
`code`	`string`	错误码/成功码（业务码）详情请见下错误码表格
`msg`	`string`	提示信息
`serverTime`	`long`	响应生成时间戳（毫秒）
`success`	`boolean`	请求是否成功，`false` 表示失败

失败响应示例

{
  "code": "600006",
  "msg": "Payment failed.",
  "serverTime": 1766742432795,
  "success": false
}

错误码

错误码	描述	中文说明
600001	Merchant is now invalid - Contact futurepay to enable the account.	商户状态无效，请联系 FuturePay 启用该账户
600006	Payment failed.	通道支付失败
600008	Insufficient Balance.	余额不足
600020	FromAccount and toAccount must be different	fromAccount 与 toAccount 不允许相同
600022	Transfer account invalid.	划转类型无效

实际错误码以平台返回为准

注意事项

本接口为钱包内部余额划转，不涉及真实资金出入金
划转成功后，建议通过**查询代付钱包余额**接口获取最新余额
请勿重复提交相同请求，避免产生重复划转