开放平台
取消
服务商
中文
EN
取消
  • 服务市场

    • # 查询订单列表

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

    接口英文名：queryOrderList

    服务商可通过本接口查询已购买商品的订单列表。

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/wxa/charge/service-provider/order/query_list?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用。

    # 第三方调用

    • 本接口不支持第三方平台调用。

    # 2. 请求参数

    # 查询参数 Query String Parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token

    # 请求体 Request Payload

    参数名类型必填说明
    spuIdstring是商品SPU ID
    offsetnumber是分页偏移量，从0开始
    limitnumber是每页个数，最大20

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    totalnumber本次查询结果的总个数
    orderListobjarray订单列表

    # Res.orderList(Array) Object Payload

    订单列表

    参数名类型说明枚举
    orderIdstring订单ID-
    statusnumber订单状态枚举值
    createTimenumber订单创建时间戳（单位：毫秒）-
    updateTimenumber订单更新时间戳（单位：毫秒）-
    orderPricestring订单价格（单位：分，64位数字）-
    payInfoobject支付相关数据-
    orderProductInfoobject订单购买的商品信息，定义见OrderProductInfo-
    invoiceInfoobject发票相关数据，未申请发票不返回该字段-
    usageobject订单购买资源包的用量情况，未支付成功不返回该字段-

    # Res.orderList(Array).payInfo Object Payload

    支付相关数据

    参数名类型说明
    applyPayTimenumber支付下单时间戳（单位：秒）
    finishPayTimenumber支付完成时间戳（单位：秒），未支付成功不返回该字段

    # Res.orderList(Array).orderProductInfo Object Payload

    订单购买的商品信息，定义见OrderProductInfo

    参数名类型说明
    spSpuIdstring服务商采购的批发商品SPU ID
    spSkuIdstring服务商采购的批发商品SKU ID
    spBizIdnumber服务商采购的批发商品业务ID
    spuNamestring商品SPU名称
    skuNamestring商品SKU名称
    skuCntnumber购买SKU个数
    validityBeginTimenumber资源包有效期开始时间戳（单位：秒）
    validityEndTimenumber资源包有效期截止时间戳（单位：秒）

    # Res.orderList(Array).invoiceInfo Object Payload

    发票相关数据，未申请发票不返回该字段

    参数名类型说明枚举
    invoiceApplyTimenumber发票申请时间戳（单位：秒）-
    invoiceStatusnumber发票申请状态枚举值

    # Res.orderList(Array).usage Object Payload

    订单购买资源包的用量情况，未支付成功不返回该字段

    参数名类型说明
    usedstring已使用（64位数字）
    allstring总量（64位数字）

    # 4. 枚举信息

    # Res.orderList(Array).status Enum

    订单状态

    枚举值描述
    1待支付
    2支付成功
    3订单超时
    5退款中
    6退款成功
    7退款失败
    9订单取消

    # Res.orderList(Array).invoiceInfo.invoiceStatus Enum

    发票申请状态

    枚举值描述
    1开票中
    2已开票
    3开票取消
    4开票失败

    # 5. 注意事项

    本接口无特殊注意事项

    # 6. 代码示例

    请求示例

    {
  "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
}

    # 7. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述解决方案
    10120002参数错误检查参数
    10120020系统异常请重试
    10120405方法不可用对照文档使用正确的方法请求

    # 8. 适用范围

    本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明，均不可调用。