查询订单

2024-06-18 09:05| 来源: 网络整理| 查看: 265

# 查询订单

使用本接口需要开启开放接口服务

该接口提供所有微信支付订单的查询，商户可以通过该接口主动查询订单状态，完成下一步的业务逻辑。

需要调用查询接口的情况：

当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；调用支付接口后，返回系统错误或未知交易状态情况；调用被扫支付API，返回USERPAYING的状态；调用关单或撤销接口API之前，需确认支付状态； # 接口地址 http://api.weixin.qq.com/_/pay/queryorder # 入参数据 { "out_trade_no":"2021WERUN1647840687637", "sub_mch_id":"1712734762" } # 出参数据 { "errcode":0, "errmsg":"ok", "respdata":{ "return_code":"SUCCESS", "return_msg":"OK", "appid":"wxd2565e6a04246fd1", "mch_id":"1800780001", "sub_appid":"wxd2565e6a04246fd1", "sub_mch_id":"1712734762", "nonce_str":"C5h9TIF57KyXXr3M", "sign":"99C4B35B4DE79AD46B9F6F541F3EF586", "result_code":"SUCCESS", "openid":"oPoIm-roYxAo441g3WD3D_6I-4bE", "is_subscribe":"N", "sub_openid":"oCKlip5njeZWaC4oeOVEoXi1TTsk", "trade_type":"JSAPI", "trade_state":"SUCCESS", "bank_type":"OTHERS", "total_fee":1, "fee_type":"CNY", "cash_fee":1, "cash_fee_type":"CNY", "coupon_id_list":[], "coupon_type_list":[], "coupon_fee_list":[], "transaction_id":"4204860361200001213072203688", "out_trade_no":"2021WERUN1647840687637","attach":"", "time_end":"20220321135131", "trade_state_desc":"测试微信支付" } } # 参数说明字段名变量名必填类型示例值描述子商户号 sub_mch_id 是 String(32) 1900000109 微信支付分配的子商户号微信订单号 transaction_id 二选一 String(32) 1009660380201506130728806387 微信的订单号，优先使用商户订单号 out_trade_no String(32) 1217752501201407033233368018 商户系统内部订单号，要求32个字符内，只能是数字、大小写字母_- *@ ，且在同一个商户号下唯一。随机字符串 nonce_str 是 String(32) C380BEC2BFD727A4B6845133519F3AD6 随机字符串，不长于32位。推荐随机数生成算法# 返回值说明字段名变量名必填类型示例值描述返回状态码 return_code 是 String(16) SUCCESS SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看trade_state来判断返回信息 return_msg 否 String(128) 签名失败返回信息，如非空，为错误原因。如签名失败、参数格式校验错误

以下字段在return_code为SUCCESS的时候有返回

字段名变量名必填类型示例值描述服务商的APPID appid 是 String(32) wxd678efh567hg6787 服务商商户的APPID 商户号 mch_id 是 String(32) 1230000109 微信支付分配的商户号小程序的APPID sub_appid 是 String(32) wx8888888888888888 微信分配的小程序ID 子商户号 sub_mch_id 是 String(32) 1900000109 微信支付分配的子商户号随机字符串 nonce_str 是 String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 随机字符串，不长于32位。推荐随机数生成算法签名 sign 是 String(32) C380BEC2BFD727A4B6845133519F3AD6 签名，详见签名生成算法业务结果 result_code 是 String(16) SUCCESS SUCCESS/FAIL 错误代码 err_code 否 String(32) SYSTEMERROR 错误码错误代码描述 err_code_des 否 String(128) 系统错误结果信息描述

以下字段在returnCode 和result_code都为SUCCESS的时候有返回

字段名变量名必填类型示例值描述设备号 device_info 否 String(32) 013467007045764 微信支付分配的终端设备号，用户标识 openid 是 String(128) oUpF8uMuAJO_M2pxb1Q9zNjWeS6o 用户在商户appid下的唯一标识是否关注公众账号 is_subscribe 是 String(1) Y 用户是否关注公众账号，Y-关注，N-未关注用户子标识 sub_openid 否 String(128) wxd930ea5d5a258f4f 用户在子商户appid下的唯一标识是否关注子公众账号 sub_is_subscribe 否 String(1) Y 用户是否关注子公众账号，Y-关注，N-未关注交易类型 trade_type 是 String(16) JSAPI 调用接口提交的交易类型，取值如下：JSAPI，NATIVE，APP，MICROPAY，详细说明见参数规定交易状态 trade_state 是 String(32) SUCCESS SUCCESS—支付成功 REFUND—转入退款 NOTPAY—未支付 CLOSED—已关闭 REVOKED—已撤销（刷卡支付） USERPAYING--用户支付中 PAYERROR--支付失败(其他原因，如银行返回失败) 付款银行 bank_type 是 String(16) CMC 银行类型，采用字符串类型的银行标识订单金额 total_fee 是 Int 100 订单总金额，单位为分标价币种 fee_type 否 String(8) CNY 货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型应结订单金额 settlement_total_fee 否 Int 100 当订单使用了免充值型优惠券后返回该参数，应结订单金额=订单金额-免充值优惠券金额。现金支付金额 cash_fee 是 Int 100 现金支付金额订单现金支付金额，详见支付金额现金支付货币类型 cash_fee_type 否 String(16) CNY 货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型代金券金额 coupon_fee 否 Int 100 “代金券或立减优惠”金额

【本文地址】

公司简介

联系我们