通用场景
为支付宝商家提供支付宝账户充值，转账，提现信息，供对账使用。
公共请求参数
业务请求参数
start_time必选string(20)
【描述】充值、转账、提现流水业务时间的起始范围
【示例值】2019-01-01 00:00:00
end_time必选string(20)
【描述】充值、转账、提现流水业务时间的结束范围。与起始时间间隔不超过31天。查询结果为起始时间至结束时间的左闭右开区间
【示例值】2019-01-02 00:00:00
type必选string(20)
【描述】转账类型：充值-deposit，提现-withdraw，转账-transfer。
【枚举值】
充值: deposit
提现: withdraw
转账: transfer
【示例值】deposit
page_no可选string(8)
【描述】分页号，从1开始
【示例值】1
page_size可选string(8)
【描述】分页大小1000-2000，默认2000
【示例值】2000
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.data.bill.transfer.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"start_time":"2019-01-01 00:00:00",
"end_time":"2019-01-02 00:00:00",
"type":"deposit",
"page_no":"1",
"page_size":"2000"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
page_no必选string(8)
【描述】分页号，从1开始
【示例值】1
page_size必选string(8)
【描述】分页大小1000-2000
【示例值】2000
total_size必选string(32)
【描述】充值、提现、转账明细总数。返回满足查询条件的明细的数量
【示例值】10000
detail_list可选transferdetailresult[]
【描述】充值、提现、转账明细记录
trans_dt必选string(20)
【描述】业务发生时间
【示例值】2019-01-01 00:00:00
order_no必选string(255)
【描述】业务订单号。该笔业务单据的唯一识别编号
【示例值】20190101***
type_desc必选string(20)
【描述】查询类型描述：充值、转账、提现
【枚举值】
充值: 充值
转账: 转账
提现: 提现
【示例值】充值
fund_desc必选string(255)
【描述】资金来源/去向类型。在充值记录中，表示资金来源类型，在转账和提现类型中，表示去向类型
【示例值】银行卡
account必选string(255)
【描述】付款/收款账户。充值记录中是付款账户。提现、转账记录中是收款账户。支付宝名称及账号脱敏；银行账户的户名脱敏，银行账户显示银行名称 银行卡号后四位
【示例值】*三（招商银行2456）
amount必选string(20)
【描述】金额，人民币元
【示例值】100.00
status必选string(20)
【描述】资金状态
【枚举值】
成功: 成功
失败: 失败
审批中: 审批中
【示例值】成功
sub_type_desc可选string(255)
【描述】子类型。“充值类型”，普通充值、大额充值。“转账类型”，暂无实现。转账至支付宝账户、转账至银行卡、批量转账支付宝账户、批量转账至银行卡、批量付款。“提现类型”，暂无实现。普通提现、批量委托提现。对账使用，无需脱敏
【示例值】普通充值
service_fee可选string(20)
【描述】服务费金额，人民币元
【示例值】1.00
instruction_id可选string(255)
【描述】银行单据号。对账使用，无需脱敏
【示例值】20190101***
memo可选string(255)
【描述】备注信息
【示例值】普通充值
响应示例
正常示例
异常示例
{
"alipay_data_bill_transfer_query_response": {
"code": "10000",
"msg": "success",
"page_no": "1",
"page_size": "2000",
"total_size": "10000",
"detail_list": [
{
"trans_dt": "2019-01-01 00:00:00",
"order_no": "20190101***",
"type_desc": "充值",
"sub_type_desc": "普通充值",
"fund_desc": "银行卡",
"account": "*三（招商银行2456）",
"amount": "100.00",
"service_fee": "1.00",
"status": "成功",
"instruction_id": "20190101***",
"memo": "普通充值"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| system_busy | 业务繁忙，转账接口查询过多，请降低查询频率，并稍后后重试 | 请稍后重试 |
| system_rate_limit | 系统当前负载较高，请求被限流，请稍后重试 | 间隔1分钟后重试 |
| user_rate_limit | 调用频率超限 | 间隔1分钟后重试，查看 调用频率限制 中新增的2.4请求频次 |