通用场景
为支付宝商家提供支付宝账户历史余额信息，供对账使用。
公共请求参数
业务请求参数
biz_date可选string(20)
【描述】查询指定自然日的起初余额和期末余额，biz_date与biz_month传入参数互斥
【示例值】2019-08-01
biz_month可选string(20)
【描述】查询指定自然月的起初余额和期末余额，biz_date与biz_month传入参数互斥
【示例值】2019-08
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.data.bill.balancehis.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"biz_date":"2019-08-01",
"biz_month":"2019-08"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
beginning_balance必选string(32)
【描述】期初余额，单位（元）
【示例值】10000.00
ending_balance必选string(32)
【描述】期末余额，单位（元）
【示例值】11000.00
响应示例
正常示例
异常示例
{
"alipay_data_bill_balancehis_query_response": {
"code": "10000",
"msg": "success",
"beginning_balance": "10000.00",
"ending_balance": "11000.00"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| processing | 数据准备中，请稍后重试 | 如果前一天记录还没产出，请于9点后重试。如果查询的是几天前的，就需要联系小二排查。 |
| system_busy | 业务繁忙 | 请稍后重试 |
| system_rate_limit | 系统当前负载较高，请求被限流，请稍后重试 | 间隔1分钟后重试 |
| user_rate_limit | 调用频率超限 | 间隔1分钟后重试，查看 调用频率限制 中新增的2.4 请求频次 |