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