微信支付-JSAPI支付開(kāi)發(fā)者文檔

返回上一層基礎(chǔ)支付 / JSAPI支付 / 查詢訂單

查詢訂單

最新更新時(shí)間：2021.1.14 版本說(shuō)明

該接口提供所有微信支付訂單的查詢，商戶可以通過(guò)查詢訂單接口主動(dòng)查詢訂單狀態(tài)，完成下一步的業(yè)務(wù)邏輯。

注意：

需要調(diào)用查詢接口的情況：

● 當(dāng)商戶后臺(tái)、網(wǎng)絡(luò)、服務(wù)器等出現(xiàn)異常，商戶系統(tǒng)最終未接收到支付通知；

● 調(diào)用支付接口后，返回系統(tǒng)錯(cuò)誤或未知交易狀態(tài)情況；

● 調(diào)用刷卡支付API，返回USERPAYING的狀態(tài)；

接口說(shuō)明

適用對(duì)象：直連商戶服務(wù)商

請(qǐng)求URL： https://api.mch.weixin.qq.com/pay/orderquery

冗災(zāi)備用URL：https://api2.mch.weixin.qq.com/pay/orderquery(備用域名)見(jiàn)跨城冗災(zāi)方案

請(qǐng)求方式： POST

數(shù)據(jù)格式： XML

是否需要證書(shū)： 否

請(qǐng)求參數(shù)

參數(shù)名	變量	類型	必填	描述
應(yīng)用ID	appid	string[1,32]	是	微信分配的應(yīng)用ID 示例值：wx8888888888888888
商戶號(hào)	mch_id	string[1,32]	是	微信支付分配的商戶號(hào) 示例值：1900000109
子商戶應(yīng)用ID	sub_appid	string[1,32]	否	微信分配的子商戶應(yīng)用ID，如需在支付完成后獲取sub_openid則此參數(shù)必傳。注意：僅適用于服務(wù)商模式示例值：wx8888888888888888
子商戶號(hào)	sub_mch_id	string[1,32]	是	微信支付分配的子商戶號(hào) 注意：僅適用于服務(wù)商模式示例值：1900000109
微信支付訂單號(hào)	transaction_id	string[1,32]	二選一	微信的訂單號(hào)，優(yōu)先使用示例值：1217752501201407033233368018
商戶訂單號(hào)	out_trade_no	string[1,32]	二選一	商戶系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫字母_-\|*@ ，且在同一個(gè)商戶號(hào)下唯一。示例值：1217752501201407033233368018
隨機(jī)字符串	nonce_str	string[1,32]	是	隨機(jī)字符串，不長(zhǎng)于32位。推薦隨機(jī)數(shù)生成算法示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS
簽名	sign	string[1,64]	是	簽名，詳見(jiàn)簽名生成算法示例值：C380BEC2BFD727A4B6845133519F3AD6

請(qǐng)求示例：


<xml>
  <appid>wx2421b1c4370ec43b</appid>
  <mch_id>10000100</mch_id>
  <nonce_str>ec2316275641faa3aacf3cc599e8730f</nonce_str>
  <transaction_id>1008450740201411110005820873</transaction_id>
  <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
</xml>：

    
｛
JAVA示例代碼
｝

返回參數(shù)

正常返回

參數(shù)名	變量	類型	必填	描述
返回狀態(tài)碼	return_code	string[1,16]	是	SUCCESS/FAIL 此字段是通信標(biāo)識(shí)，非交易標(biāo)識(shí)，交易是否成功需要查看result_code來(lái)判斷示例值：SUCCESS
返回信息	return_msg	string[1,128]	否	返回信息，如非空，為錯(cuò)誤原因簽名失敗參數(shù)格式校驗(yàn)錯(cuò)誤示例值：簽名失敗

返回狀態(tài)碼(return_code)為SUCCESS的時(shí)候,包含以下字段

參數(shù)名	變量	類型	必填	描述
應(yīng)用ID	appid	string[1,32]	是	微信分配的應(yīng)用ID 示例值：wx8888888888888888
商戶號(hào)	mch_id	string[1,32]	是	微信支付分配的商戶號(hào) 示例值：1900000109
子商戶應(yīng)用ID	sub_appid	string[1,32]	否	微信分配的子商戶應(yīng)用ID，如需在支付完成后獲取sub_openid則此參數(shù)必傳。注意：僅適用于服務(wù)商模式示例值：wx8888888888888888
子商戶號(hào)	sub_mch_id	string[1,32]	是	微信支付分配的子商戶號(hào) 注意：僅適用于服務(wù)商模式示例值：1900000109
隨機(jī)字符串	nonce_str	string[1,32]	是	隨機(jī)字符串，不長(zhǎng)于32位。推薦隨機(jī)數(shù)生成算法示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS
簽名	sign	string[1,64]	是	簽名，詳見(jiàn)簽名生成算法示例值：C380BEC2BFD727A4B6845133519F3AD6
業(yè)務(wù)結(jié)果	result_code	string[1,16]	是	SUCCESS/FAIL 示例值：SUCCESS
錯(cuò)誤代碼	err_code	string[1,32]	否	詳細(xì)參見(jiàn)錯(cuò)誤列表示例值：SYSTEMERROR
錯(cuò)誤代碼描述	err_code_des	string[1,128]	否	結(jié)果信息描述示例值：系統(tǒng)錯(cuò)誤

返回狀態(tài)碼(return_code)和業(yè)務(wù)結(jié)果（result_code）、交易狀態(tài)（trade_state）都為SUCCESS的時(shí)候,包含以下字段

參數(shù)名

變量

類型

必填

描述

設(shè)備號(hào)

device_info

string[1,32]

否

調(diào)用接口提交的終端設(shè)備號(hào)，
示例值：013467007045764

用戶標(biāo)識(shí)

openid

string[1,128]

否

用戶在主商戶appid下的唯一標(biāo)識(shí)
示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

是否關(guān)注公眾賬號(hào)

is_subscribe

string[1,1]

是

用戶是否關(guān)注公眾賬號(hào)，枚舉值：
Y：關(guān)注
N：未關(guān)注
（機(jī)構(gòu)商戶不返回）
示例值：Y

用戶子標(biāo)識(shí)

sub_openid

string[1,128]

否

t用戶在子商戶appid下的唯一標(biāo)識(shí)
注意：僅適用于服務(wù)商模式
示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

是否關(guān)注子公眾賬號(hào)

sub_is_subscribe

string[1,1]

否

用戶是否關(guān)注子公眾賬號(hào)，枚舉值：
Y：關(guān)注
N：未關(guān)注
（機(jī)構(gòu)商戶不返回）
示例值：Y

交易類型

trade_type

string[1,16]

是

JSAPI：JSAPI支付（或小程序支付）
NATIVE：Native支付
APP：APP支付
MWEB：H5支付
說(shuō)明詳見(jiàn)交易類型
示例值：JSAPI

交易狀態(tài)

trade_state

string[1,32]

是

SUCCESS：支付成功
REFUND：轉(zhuǎn)入退款
NOTPAY：未支付
CLOSED：已關(guān)閉
REVOKED：已撤銷(刷卡支付)
USERPAYING：用戶支付中
PAYERROR：支付失敗(其他原因，如銀行返回失敗)
ACCEPT：已接收，等待扣款
示例值：JSAPI

付款銀行

bank_type

string[1,32]

是

銀行類型，采用字符串類型的銀行標(biāo)識(shí)
示例值：CMC

+ 商品詳情

detail

string[1,8192]

否

商品詳細(xì)列表，使用Json格式。如果使用了單品優(yōu)惠，會(huì)有單品優(yōu)惠信息返回
示例值：JSAPI

參數(shù)名

變量

類型[長(zhǎng)度限制]

必填

描述

+ 單品列表

goods_detail

string[1,8192]

否

單品信息，使用Json數(shù)組格式提交

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
商品編碼	goods_id	string[1,32]	是	由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成示例值：SZTX001
微信支付商品編碼	wxpay_goods_id	string[1,32]	否	微信支付定義的統(tǒng)一商品編號(hào)（沒(méi)有可不傳）示例值：1001
商品名稱	goods_name	string[1,6]	否	商品的實(shí)際名稱示例值：iPhone6s 16G
商品數(shù)量	quantity	int	是	用戶購(gòu)買的數(shù)量示例值：1
商品單價(jià)	price	int	是	單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價(jià)(例如：用戶對(duì)一筆100元的訂單使用了商場(chǎng)發(fā)的紙質(zhì)優(yōu)惠券100-50，則活動(dòng)商品的單價(jià)應(yīng)為原單價(jià)-50) 示例值：100

標(biāo)價(jià)金額

total_fee

int

是

訂單總金額，單位為分
示例值：100

標(biāo)價(jià)幣種

fee_type

string[1,8]

否

貨幣類型，符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，默認(rèn)人民幣：CNY，其他值列表詳見(jiàn)貨幣類型
示例值：CNY

應(yīng)結(jié)訂單金額

settlement_total_fee

int

否

當(dāng)訂單使用了免充值型優(yōu)惠券后返回該參數(shù)，應(yīng)結(jié)訂單金額=訂單金額-免充值優(yōu)惠券金額。
示例值：100

現(xiàn)金支付金額

cash_fee

int

是

現(xiàn)金支付金額訂單現(xiàn)金支付金額，詳見(jiàn)交易金額
示例值：100

現(xiàn)金支付貨幣類型

cash_fee_type

string[1,16]

否

貨幣類型，符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，默認(rèn)人民幣：CNY，其他值列表詳見(jiàn)貨幣類型
示例值：CNY

代金券金額

coupon_fee

int

否

“代金券或立減優(yōu)惠”金額<=訂單總金額，訂單總金額-“代金券或立減優(yōu)惠”金額=現(xiàn)金支付金額，詳見(jiàn)交易金額
示例值：100

代金券使用數(shù)量

coupon_count

int

否

代金券或立減優(yōu)惠使用數(shù)量
示例值：1

代金券ID

coupon_id_$n

string[1,20]

否

代金券或立減優(yōu)惠ID, $n為下標(biāo)，從0開(kāi)始編號(hào)
示例值：10000

代金券類型

coupon_type_$n

String

否

CASH：充值代金券
NO_CASH：非充值優(yōu)惠券
開(kāi)通免充值券功能，并且訂單使用了優(yōu)惠券后有返回（取值：CASH、NO_CASH）。$n為下標(biāo),從0開(kāi)始編號(hào)，舉例：coupon_type_$0
示例值：CASH

單個(gè)代金券金額

coupon_fee_$n

int

否

單個(gè)代金券或立減優(yōu)惠支付金額, $n為下標(biāo)，從0開(kāi)始編號(hào)
示例值：100

微信支付訂單號(hào)

transaction_id

string[1,32]

是

微信支付訂單號(hào)
示例值：1217752501201407033233368018

商戶訂單號(hào)

out_trade_no

string[1,32]

是

商戶系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫字母_-|*@ ，且在同一個(gè)商戶號(hào)下唯一。
示例值：1217752501201407033233368018

商家數(shù)據(jù)包

attach

string[1,128]

否

商家數(shù)據(jù)包，原樣返回
示例值：123456

支付完成時(shí)間

time_end

string[1,14]

是

訂單支付時(shí)間，格式為yyyyMMddHHmmss，如2009年12月25日9點(diǎn)10分10秒表示為20091225091010。其他詳見(jiàn)時(shí)間規(guī)則
示例值：20141030133525

交易狀態(tài)描述

trade_state_desc

string[1,256]

是

對(duì)當(dāng)前查詢訂單狀態(tài)的描述和下一步操作的指引
示例值：支付失敗，請(qǐng)重新下單支付

返回示例：

正常示例

<xml>
  <return_code><![CDATA[SUCCESS]]></return_code>
  <return_msg><![CDATA[OK]]></return_msg>
  <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
  <mch_id><![CDATA[10000100]]></mch_id>
  <device_info><![CDATA[1000]]></device_info>
  <nonce_str><![CDATA[TN55wO9Pba5yENl8]]></nonce_str>
  <sign><![CDATA[BDF0099C15FF7BC6B1585FBB110AB635]]></sign>
  <result_code><![CDATA[SUCCESS]]></result_code>
  <openid><![CDATA[oUpF8uN95-Ptaags6E_roPHg7AG0]]></openid>
  <is_subscribe><![CDATA[Y]]></is_subscribe>
  <trade_type><![CDATA[MICROPAY]]></trade_type>
  <bank_type><![CDATA[CCB_DEBIT]]></bank_type>
  <total_fee>1</total_fee>
  <fee_type><![CDATA[CNY]]></fee_type>
  <transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id>
  <out_trade_no><![CDATA[1415757673]]></out_trade_no>
  <attach><![CDATA[訂單額外描述]]></attach>
  <time_end><![CDATA[20141111170043]]></time_end>
  <trade_state><![CDATA[SUCCESS]]></trade_state>
</xml>


http://2323weixin.qq.com

錯(cuò)誤碼

錯(cuò)誤碼	描述	解決方案
ORDERNOTEXIST	此交易訂單號(hào)不存在	該API只能查提交支付交易返回成功的訂單，請(qǐng)商戶檢查需要查詢的訂單號(hào)是否正確
SYSTEMERROR	系統(tǒng)錯(cuò)誤	系統(tǒng)異常，請(qǐng)?jiān)僬{(diào)用發(fā)起查詢

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

微信支付商戶平臺(tái)

JSAPI支付

查詢訂單

注意：

接口說(shuō)明

請(qǐng)求參數(shù)

請(qǐng)求示例：

返回參數(shù)

正常返回

返回示例：

錯(cuò)誤碼

版本說(shuō)明