# 查询订单列表
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
queryOrderList
# 功能描述
- 服务商可通过本接口查询已购买商品的订单列表。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/charge/service-provider/order/query_list?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。access_token可通过getAccessToken接口获得。 |
spuId | string | 是 | 商品SPU ID |
offset | number | 是 | 分页偏移量,从0开始 |
limit | number | 是 | 每页个数,最大20 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
total | number | 本次查询结果的总个数 |
orderList | array | 订单列表,具体定义参见查询订单详情接口中定义的Order |
# 调用示例
示例说明: HTTPS调用
# 请求数据示例
POST https://api.weixin.qq.com/wxa/charge/service-provider/order/query_list?access_token=ACCESS_TOKEN
{
"offset": 0,
"limit": 10,
"spuId": "10000000"
}
# 返回数据示例
{
"errcode": 0,
"orderList": [
{
"orderId": "DD2981741311549200000",
"status": 2,
"createTime": 1687265841964,
"updateTime": 1687267671475,
"orderPrice": "1",
"payInfo": {
"applyPayTime": 1687265845,
"finishPayTime": 1687265856
},
"orderProductInfo": {
"spSpuId": "10000111",
"spSkuId": "20000176",
"skuCnt": 1,
"spBizId": 100100,
"spuName": "spu name",
"skuName": "sku name",
"validityBeginTime": 1687265856,
"validityEndTime": 1718801856
},
"invoiceInfo": {
"invoiceStatus": 2,
"invoiceApplyTime": 1687265870
},
"usage": {
"used": "0",
"all": "1000"
}
}
],
"total": 6
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
10120002 | 参数错误 | 检查参数 |
10120020 | 系统异常 | 请重试 |
10120405 | 方法不可用 | 对照文档使用正确的方法请求 |