小游戏
取消
开发
中文
EN
取消
  • 服务端

    • # 查询订单状态

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

    接口英文名：pay_v2.queryOrder

    本接口用于查看订单状态

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/wxa/game/queryorderinfo?access_token=ACCESS_TOKEN&signature=SIGNATURE&sig_method=SIG_METHOD&pay_sig=PAY_SIG

    # 云调用

    • 本接口不支持云调用。

    # 第三方调用

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

    # 2. 请求参数

    # 查询参数 Query String Parameters

    参数名类型必填说明
    access_tokenstring是接口调用凭证，可使用 access_token
    signaturestring是用户登录态签名
    sig_methodstring是用户登录态签名的哈希方法，只支持 hmac_sha256，请传入"hmac_sha256"
    pay_sigstring是支付请求签名（pay_sig）算法说明

    # 请求体 Request Payload

    参数名类型必填说明枚举
    openidstring是用户唯一标识符-
    offer_idstring是支付应用 ID（OfferId）-
    tsnumber是当前 UNIX 时间戳（请尽可能确保时间准确），单位：秒 如：1668136271-
    zone_idstring是已发布的分区 ID（MP-分区配置-分区 ID） ；需要和 env 对应-
    envnumber是环境配置枚举值
    out_trade_nostring是充值时传入的外部订单号-
    biz_idnumber是1 代币 2 道具直购-

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    product_idstring道具 id
    pay_statenumber支付状态（用户是否已支付）1 未支付 2 已支付
    deliver_statenumber发货状态（如果是游戏币，则是余额是否增加） 1 未发货 2 已发货
    pay_finish_timenumber支付完成时间
    out_trade_nostring充值时传入的外部订单号
    mch_order_nostring微信支付商户单号（仅微信支付方式存在）
    transaction_idstring交易单号（微信支付订单号，仅微信支付方式存在）

    # 4. 枚举信息

    # Body.env Enum

    环境配置

    枚举值描述
    0现网环境（也叫正式环境）
    1沙箱环境

    # 5. 注意事项

    本接口无特殊注意事项

    # 6. 代码示例

    # 6.1 请求示例

    请求示例

    {
  "openid": "oUrsfxxxxxxxxxx",
  "ts": 1668512806,
  "env": 0,
  "out_trade_no": "test_queryorderinfo_1668512806",
  "offer_id":"xxxx",
  "biz_id":1
}

    返回示例

    {
  "errcode": 0,
  "errmsg": "ok",
  "out_trade_no": "test_queryorderinfo_1668512806",
  "pay_finish_time": 1669364790,
  "product_id": "id_100001",
  "deliver_state": 1,
  "pay_state": 1,
  "mch_order_no": "1217752501201407033233368018",
  "transaction_id": "1217752501201407033233368018"
}

    # 6.2 请求示例

    请求示例

    {
  "openid": "oUrsfxxxxxxxxxx",
  "ts": 1668512806,
  "env": 0,
  "out_trade_no": "test_queryorderinfo_1668512806",
  "offer_id":"xxxx",
  "biz_id":1
}

    返回示例

    {
  "errcode": 90018,
  "errmsg": "[openid] openid is invalid"
}

    # 7. 错误码

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

    错误码错误描述
    -1系统繁忙，此时请开发者稍候再试
    0请求成功
    90010signature 签名错误
    90011pay_sig 签名错误
    90016sessionkey fail，用户 sessionkey 过期，需要重走登录流程
    90018参数错误，具体参数见 errmsg 描述
    90019out_trade_no 未找到

    # 8. 适用范围

    本接口支持「小游戏（仅认证）」账号类型调用。其他账号类型如无特殊说明，均不可调用。

    点击咨询小助手