通用场景
为支付宝商家提供支付宝账户保证金信息，供对账使用。
公共请求参数
业务请求参数
start_time必选string(20)
【描述】保证金流水创建时间的起始范围
【示例值】2019-01-01 00:00:00
end_time必选string(20)
【描述】保证金流水创建时间的结束范围。与起始时间间隔不超过31天。查询结果为起始时间至结束时间的左闭右开区间
【示例值】2019-01-02 00:00:00
bail_type必选string(20)
【描述】保证金类型，目前支持tmall_s_bail-天猫保证金，taobao_bail-淘宝保证金
【示例值】tmall_s_bail
trans_log_id可选string(255)
【描述】保证金流水号。如果查询参数中指定流水号，则只查询流水号相关的记录
【示例值】20190101***
biz_orig_no可选string(255)
【描述】业务基础订单号。如果查询参数中指定订单号，则只查询相关的记录
【示例值】1***
常见请求示例
默认示例
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipaydatabillbailqueryrequest request = new alipaydatabillbailqueryrequest();
request.setbizcontent("{"
" \"start_time\":\"2019-01-01 00:00:00\","
" \"end_time\":\"2019-01-02 00:00:00\","
" \"bail_type\":\"tmall_s_bail\","
" \"trans_log_id\":\"20190101***\","
" \"biz_orig_no\":\"1***\""
"}");
alipaydatabillbailqueryresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}说明：本示例仅供参考。
公共响应参数
业务响应参数
detail_list必选baildetailresult[]
【描述】保证金明细列表，最多返回5000条
trans_dt必选string(20)
【描述】业务发生时间
【示例值】2019-01-01 00:00:00
trans_log_id必选string(255)
【描述】保证金业务流水号
【示例值】20190101***
bail_type必选string(255)
【描述】保证金类型描述，仅供参考
【示例值】天猫保证金
amount必选string(32)
【描述】保证金收支金额
【示例值】10.00
balance必选string(32)
【描述】本次操作后的保证金余额。字段数据展示为"--"，表明数据暂未更新，请稍等1分钟后重试。
【示例值】1000.00
memo可选string(255)
【描述】保证金说明
【示例值】保证金冻结
biz_desc可选string(255)
【描述】业务描述，资金收支对应的详细业务场景信息
【示例值】余额账户迁入
biz_orig_no可选string(255)
【描述】业务基础订单号，资金收支对应的原始业务订单唯一识别编号
【示例值】1***
响应示例
正常示例
异常示例
{
"alipay_data_bill_bail_query_response": {
"code": "10000",
"msg": "success",
"detail_list": [
{
"trans_dt": "2019-01-01 00:00:00",
"trans_log_id": "20190101***",
"bail_type": "天猫保证金",
"amount": "10.00",
"balance": "1000.00",
"memo": "保证金冻结",
"biz_desc": "余额账户迁入",
"biz_orig_no": "1***"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 稍后重试或联系小二排查问题 |
| invalid_parameter | 参数有误 | 根据错误描述进行修改后，重新查询 |
| system_busy | 业务繁忙 | 请稍后重试 |