跳转到内容

查询卡余额 ​

GET /openapi/v2/cards/balance
项内容
请求方法GET
请求路径/openapi/v2/cards/balance
请求类型query

请求参数:

字段类型必填说明
cardIdstring是卡 ID。

响应 data:

字段类型说明
cardIdstring卡 ID。
fpCardAccountIdstringFuturePay 平台卡账户 ID。
balances[]array账户余额列表。
balances[].accountIdstring账户 ID。
balances[].assets[]array资产余额列表。
balances[].assets[].assetstring资产代码;值域未封闭。
balances[].assets[].availablestring可用余额。
balances[].assets[].balancestring账面余额。
notestring响应备注。
currencystring兼容单资产余额的资产代码;值域未封闭。
availablestring兼容单资产可用余额,非科学计数法十进制字符串。
ledgerstring兼容单资产账面余额,非科学计数法十进制字符串。

余额金额均为非科学计数法十进制字符串,不是 JSON 数字,且不保证保留末尾零。

如需查询卡账户额度,使用查询卡账户额度;额度与本接口的资金余额不能相加或互相替代。查看全量持卡及共享余额关联,使用查询用户持卡概览。