通用场景
为支付宝商家提供支付宝账户当前余额信息，包括冻结金额，可用余额和总额，供对账使用。
公共请求参数
业务请求参数
bill_user_id可选string(16)
【描述】目标查询账户（仅支持部分场景，查询自身时候不需要传递当前字段）。
【示例值】2088123456789012
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.data.bill.balance.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"bill_user_id":"2088123456789012"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
total_amount必选string(32)
【描述】支付宝账户余额
【示例值】10000.00
available_amount必选string(32)
【描述】账户可用余额
【示例值】9000.00
freeze_amount｜当前账户不可用金额，单位（元）必选string(32)
【描述】冻结金额。单位（元）
【示例值】1000.00
settle_amount｜当前账户的待结算金额，单位（元）可选string(32)
【描述】待结算金额，单位（元）
【示例值】500.00
响应示例
正常示例
异常示例
{
"alipay_data_bill_balance_query_response": {
"code": "10000",
"msg": "success",
"total_amount": "10000.00",
"available_amount": "9000.00",
"freeze_amount": "1000.00",
"settle_amount": "500.00"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| system_busy | 业务繁忙 | 请稍后重试 |
| system_rate_limit | 系统当前负载较高，请求被限流，请稍后重试 | 间隔1分钟后重试 |
| user_agreement_check_fail | 用户协议授权检查不通过。 | 引导用户重新授权后发起查询。 |
| user_rate_limit | 调用频率超限 | 间隔1分钟后重试，查看 调用频率限制 中新增的2.4请求频次 |