查询代付钱包余额

接口地址

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

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

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

请求参数

参数名	类型	是否必填	描述
currency	String	否	币种（如 USD、CNY），不传则查询所有币种余额
clientIp	String	是	客户端 IP 地址

示例请求体（JSON）

{
  "currency": "USD",
  "clientIp": "127.0.0.1"
}

响应参数

字段名	类型	描述
code	String	返回码，"0" 表示成功
msg	String	返回信息说明
serverTime	Long	服务端响应时间（时间戳）
data	List<Object>	业务数据（代付余额信息）
success	Boolean	是否成功（true / false）

data字段结构（余额信息）

字段名	类型	描述
currency	String	币种编码（如：UGX、USD）
balance	BigDecimal	当前账户余额

{
  "code": "0",
  "msg": "succeeded",
  "serverTime": 1749538027633,
  "data": [
    {
      "currency": "UGX",
      "balance": 9999965.20
    }
  ],
  "success": true
}

备注

1.若不传 currency，系统将返回所有支持币种的可用余额。

2.该接口仅返回“代付用途”的可用余额。

3.调用此接口前做身份和权限校验。