通用场景
为支付宝商家提供支付宝账户卖出交易信息，供对账使用。
公共请求参数
业务请求参数
start_time必选string(23)
【描述】卖出交易流水创建时间的起始范围
【示例值】2019-01-01 00:00:00
end_time必选string(23)
【描述】卖出交易流水创建时间的结束范围。与起始时间间隔不超过31天。查询结果为起始时间至结束时间的左闭右开区间
【示例值】2019-01-02 00:00:00
alipay_order_no可选string(255)
【描述】支付宝交易流水号。如果查询参数中指定流水号，则只查询流水号相关的记录
【示例值】20190101***
merchant_order_no可选string(255)
【描述】商户交易号。如果查询参数中指定交易号，则只查询相关的记录
【示例值】tx***
store_no可选string(255)
【描述】门店编号，模糊搜索
【示例值】门店1
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.sell.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",
"alipay_order_no":"20190101***",
"merchant_order_no":"tx***",
"store_no":"门店1",
"page_no":"1",
"page_size":"2000"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
page_no必选string(8)
【描述】分页号，从1开始
【示例值】1
page_size必选string(8)
【描述】分页大小1000-2000
【示例值】2000
total_size必选string(20)
【描述】账务明细总数。返回满足查询条件的明细的数量
【示例值】10000
detail_list可选tradeitemresult[]
【描述】交易流水详情，如果不存在记录则为空
gmt_create必选string(20)
【描述】交易创建时间
【示例值】2019-01-01 00:00:00
alipay_order_no必选string(255)
【描述】支付宝订单号。对账使用，不脱敏
【示例值】20190101***
merchant_order_no必选string(255)
【描述】商户订单号，创建支付宝交易时传入的信息。对账使用，不脱敏
【示例值】tx***
other_account必选string(255)
【描述】对方账户
【示例值】张*(a*@alipay.com)
goods_title必选string(255)
【描述】商品名称
【示例值】商品1
total_amount必选string(20)
【描述】订单金额，人民币元
【示例值】10.00
trade_status必选string(5)
【描述】订单状态(待付款,成功,关闭,待发货,待确认收货,已预付,进行中)
【枚举值】
待买家付款: 待付款
交易成功: 成功
交易关闭: 关闭
【示例值】成功
trade_type必选string(5)
【描述】业务类型，帮助商户作为对账参考
【枚举值】
即时到帐: 即时到帐
担保交易: 担保交易
【示例值】即时到帐
gmt_pay可选string(20)
【描述】交易支付时间。支付后会有值
【示例值】2019-01-01 00:00:00
gmt_refund可选string(20)
【描述】交易退款时间
【示例值】2019-01-01 02:00:00
net_mdiscount可选string(20)
【描述】商家优惠金额，人民币元
【示例值】1.00
refund_amount可选string(20)
【描述】订单退款金额，人民币元
【示例值】2.00
service_fee可选string(20)
【描述】服务费金额，人民币元
【示例值】0.10
store_no可选string(255)
【描述】门店编号
【示例值】store123
store_name可选string(255)
【描述】门店名称
【示例值】门店123
goods_memo可选string(255)
【描述】商品备注信息
【示例值】商品备注
响应示例
正常示例
异常示例
{
"alipay_data_bill_sell_query_response": {
"code": "10000",
"msg": "success",
"page_no": "1",
"page_size": "2000",
"total_size": "10000",
"detail_list": [
{
"gmt_create": "2019-01-01 00:00:00",
"gmt_pay": "2019-01-01 00:00:00",
"gmt_refund": "2019-01-01 02:00:00",
"alipay_order_no": "20190101***",
"merchant_order_no": "tx***",
"other_account": "张*(a*@alipay.com)",
"goods_title": "商品1",
"total_amount": "10.00",
"net_mdiscount": "1.00",
"refund_amount": "2.00",
"service_fee": "0.10",
"trade_status": "成功",
"trade_type": "即时到帐",
"store_no": "store123",
"store_name": "门店123",
"goods_memo": "商品备注"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| isv_business_failed | 数据量过大查询超时，请缩小查询时间范围 | 业务查询超时，一般是由于数据量过大造成的，请缩小查询时间范围 |
| system_busy | 业务繁忙 | 请稍后重试 |
| system_rate_limit | 系统流量超限 | 间隔1分钟后重试 |
| user_rate_limit | 调用频率超限 | 间隔1分钟后重试，查看 调用频率限制 新增的2.4 请求频次 |