# pay_v2.queryOrder

本接口应在服务器端调用,详细说明参见服务端API

查询订单状态。

调用方式:

# HTTPS 调用

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

# 请求参数

# Query参数

属性 类型 默认值 必填 说明
access_token string 接口调用凭证
signature string 用户登录态签名
sig_method string 用户登录态签名的哈希方法,只支持hmac_sha256,请传入"hmac_sha256"
pay_sig string 支付请求签名(pay_sig)算法说明

# POST Body

属性 类型 默认值 必填 说明
openid string 用户唯一标识符
offer_id string 支付应用ID(OfferId)
ts number 当前UNIX时间戳(请尽可能确保时间准确),单位:秒
如:1668136271
zone_id string 已发布的分区ID(MP-分区配置-分区ID)
需要和env对应
env number 环境配置
0:现网环境(也叫正式环境)
1:沙箱环境
out_trade_no string 充值时传入的外部订单号
biz_id number 1 代币 2 道具直购

# 返回值

# Object

返回的 JSON 数据包

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
product_id string 道具id
pay_state number 支付状态(用户是否已支付)1 未支付 2 已支付
deliver_state number 发货状态(如果是游戏币,则是余额是否增加) 1 未发货 2 已发货
pay_finish_time number 支付完成时间
out_trade_no string 充值时传入的外部订单号
mch_order_no string 微信支付商户单号(仅微信支付方式存在)
transaction_id string 交易单号(微信支付订单号,仅微信支付方式存在)

errcode 的合法值

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

# cURL请求

curl -d '{
  "openid": "oUrsfxxxxxxxxxx",
  "ts": 1668512806,
  "env": 0,
  "out_trade_no": "test_queryorderinfo_1668512806",
  "offer_id":"xxxx",
  "biz_id":1
}' \
  -H "Content-Type: application/json" \
  -X POST \
  'https://api.weixin.qq.com/wxa/game/notifydelivery?access_token=62_so84Zyl5MuPCjXGiR3eb1ysa1lr6aRpcprEnNpZ9ds8676ivjqRn5Zroi2Rxxx9-Yvh2zIl9oEt1hIzK0x2OrMCT5zk8nB_TG98obD_ad3tFPftfFmB7xXtcZv4PVPcbFATZT&signature=a5ec09b5677b5004495ac78eecc0aa78a4aa53c1bfa82850e4dcf1650c8a5d69&pay_sig=e654d5725976945f738caf3485c260b129dc586c797d7616ca15176fd31b5e8b&sig_method=hmac_sha256'

# 成功返回

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

# 错误返回

{
    "errcode":90018,
    "errmsg":"[openid] openid is invalid"
}
点击咨询小助手