查询商户余额

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/payin/balance

生产环境请求地址：POST https://api.futurepay.global/payin/balance

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`currency`	O	string	账户币种
`walletType`	M	string	钱包类型，依据需求传入下方表格中Code值

walletType列表

Code	Enum Name	Description
`total_balance`	`TOTAL_BALANCE`	商户总资产（包含冻结资金）
`acquiring_balance`	`ACQUIRING_BALANCE`	收单余额（收单钱包）
`collection_balance`	`COLLECTION_BALANCE`	收款余额（收单钱包）
`available_balance`	`AVAILABLE_BALANCE`	商户可用余额
`recharge_balance`	`RECHARGE_BALANCE`	充值余额（充值钱包）
`freeze_amount`	`FREEZE_AMOUNT`	冻结金额
`pending_settlement`	`PENDING_SETTLEMENT`	在途结算资金
`exchange_pending`	`PENDING_EXCHANGE`	在途换汇资金
`pending_paying`	`PENDING_PAYING`	在途支付资金

响应data参数

字段名称	类型	说明
`currency`	string	账户币种
`balance`	String	账户币种余额

集成

查询余额调用输入

{
    "currency":"USD",
    "walletType":"acquiring_balance"
}

查询余额调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1736478710257,
    "data": {
      [
        {
        "currency":"USD",
        "balance":"5332.160000"
        }
      ]
    },
    "success": true
}