查询订单支付状态

HRADER HTTP头参数

Authorization 必填 string

请参考 签名认证 生成认证信息

Accept 必填 string

请设置为 application/json

Content-Type 必填 string

请设置为 application/json

Query 查询参数

access_token 必填 string(512)

【接口调用凭证】
1、调用接口的凭证，获取方式参见《auth.getAccessToken》文档https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getAccessToken.html。
2、HTTPS方式调用时，该参数必填；云调用时无此参数。

Body 包体参数

confirm_token 选填 string(128)

【创建订单凭证】
支付时，通过“创建订单”接口获得的confirm_token。

out_request_no 选填 string(32)

【请求号】
1、与创建订单接口中的out_request_no（请求号）参数一致。
2、请求号为一次支付的唯一幂等ID，可使用小程序内部单号。要求此参数由数字、大小写字母_-|*@组成。

请求示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/f2fminiprogram/orderinfo/query?access_token=ACCESS_TOKEN \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "confirm_token" : "AAR9o3oBAAABAAAAAACcVFuxWuzKgy90C7CfXiAAAAAnBTsSQzkr56J5EMO7tdtVJMDN0H0hoskk0/wgPrsYjC5OhHIRGOsBg6q2Zq0vei6/4C87U2LN88+mnlguzO9/DKb6CYbzY0g=",
8    "out_request_no" : "12345678901234567890"
9  }'

state 必填 string(16)

【订单支付状态】
SUCCESS—支付成功；
REFUND—转入退款；
NOTPAY—未支付；
CLOSED—已关闭；
PAYERROR--支付失败(其他原因，如银行返回失败)

order_id 选填 string(64)

【二维码收款订单号】
微信支付系统中的订单号，与用户微信账单中的单号一致

amount 选填 integer

【支付金额】
小程序提交给微信支付的订单需支付金额

create_time 选填 string(32)

【创建订单时间】
小程序通过服务端API CreateOrderInfo创建订单的时间

pay_time 选填 string(32)

【支付时间】
付款方实际支付的时间

appid 选填 string(32)

【小程序AppID】
创建订单的小程序的AppID

payer_openid 选填 string(64)

【付款方OpenID】
发起付款的用户，在本小程序AppID下的OpenID

payee_openid 选填 string(64)

【收款方OpenID】
付款方在小程序中选购商品或服务对应的用户，在本小程序AppID下的OpenID

attach 选填 string(127)

【附加数据】
1、小程序订单的附加数据，原样返回创建订单时小程序传入的附加数据，可作为自定义参数使用。
2、非必填参数，小程序可选择是否要使用

coupon_amount 选填 integer

【代金券金额】
当支付使用代金券时该字段存在。代金券金额<=订单金额，现金支付金额+代金券金额+收款方折扣金额=订单总金额

payee_discount_amount 选填 integer

【收款方折扣金额】
当支付使用收款方折扣时该字段存在。收款方折扣金额<=订单金额，现金支付金额+代金券金额+收款方折扣金额=订单总金额

payee_amount 选填 integer

【收款方实收金额】
当state=SUCCESS时，该字段存在。收款方实收金额<=订单总金额，收款方实收金额=订单总金额-收款方折扣金额-信用卡手续费金额

errcode 必填 int64

【错误码】
成功时为0，其它错误码含义详见下方错误码列表

errmsg 必填 string(128)

【错误信息】
错误原因的简要描述

应答示例

1{
2  "state" : "SUCCESS",
3  "order_id" : "1800008552202001120000971476941015",
4  "amount" : 1,
5  "create_time" : "2015-05-20T13:29:35+08:00",
6  "pay_time" : "2015-05-20T13:29:35+08:00",
7  "appid" : "wxb5950f5d226l",
8  "payer_openid" : "onqOjjmo8wmTOOtSKwXtGjg9Gb58",
9  "payee_openid" : "onqOjjmo8wmTOOtSKwXtGjg9Gb58",
10  "attach" : "attach info:xxx",
11  "coupon_amount" : 100,
12  "payee_discount_amount" : 100,
13  "payee_amount" : 100
14}