微信支付-普通下單開發(fā)者文檔

返回上一層文檔首頁 / 基礎支付（服務商模式） / 查詢訂單API

查詢訂單API

最新更新時間：2020.05.26 版本說明

商戶可以通過查詢訂單接口主動查詢訂單狀態(tài)，完成下一步的業(yè)務邏輯。查詢訂單狀態(tài)可通過微信支付訂單號或商戶訂單號兩種方式查詢

注意：

查詢訂單可通過微信支付訂單號和商戶訂單號兩種方式查詢，兩種查詢方式返回結果相同

需要調用查詢接口的情況：

? 當商戶后臺、網絡、服務器等出現異常，商戶系統(tǒng)最終未接收到支付通知。

? 調用支付接口后，返回系統(tǒng)錯誤或未知交易狀態(tài)情況。

? 調用付款碼支付API，返回USERPAYING的狀態(tài)。

? 調用關單或撤銷接口API之前，需確認支付狀態(tài)。

1、微信支付訂單號查詢

接口說明

適用對象： 服務商

請求URL： https://api.mch.weixin.qq.com/v3/pay/partner/transactions/id/{transaction_id}

請求方式：GET

接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml

path指該參數為路徑參數

query指該參數需在請求URL傳參

body指該參數需在請求JSON傳參

請求參數

參數名	變量	類型[長度限制]	必填	描述
服務商戶號	sp_mchid	string[1,32]	是	query 服務商戶號，由微信支付生成并下發(fā) 示例值：1230000109
子商戶號	sub_mchid	string[1,32]	是	query 子商戶的商戶號，有微信支付生成并下發(fā)。示例值：1900000109
微信支付訂單號	transaction_id	string[1,32]	是	path 微信支付系統(tǒng)生成的訂單號示例值：1217752501201407033233368018

請求示例


https://api.mch.weixin.qq.com/v3/pay/partner/transactions/id/1217752501201407033233368018?sp_mchid=1230000109&sub_mchid=1900000109

    
｛
JAVA示例代碼
｝

2、商戶訂單號查詢

接口說明

適用對象： 服務商

請求URL： https://api.mch.weixin.qq.com/v3/pay/partner/transactions/out-trade-no/{out_trade_no}

請求方式：GET

接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml

path指該參數為路徑參數

query指該參數需在請求URL傳參

body指該參數需在請求JSON傳參

請求參數

參數名	變量	類型[長度限制]	必填	描述
服務商戶號	sp_mchid	string[1,32]	是	query 服務商戶號，由微信支付生成并下發(fā) 示例值：1230000109
子商戶號	sub_mchid	string[1,32]	是	query 子商戶的商戶號，由微信支付生成并下發(fā)。示例值：1900000109
商戶訂單號	out_trade_no	string[1,32]	是	path 商戶系統(tǒng)內部訂單號，只能是數字、大小寫字母_-*且在同一個商戶號下唯一，詳見【商戶訂單號】。特殊規(guī)則：最小字符長度為6 示例值：1217752501201407033233368018

請求示例


https://api.mch.weixin.qq.com/v3/pay/partner/transactions/out-trade-no/1217752501201407033233368018?sp_mchid=1230000109&sub_mchid=1900000109

    
｛
JAVA示例代碼
｝

返回參數

參數名

變量

類型[長度限制]

必填

描述

服務商公眾號ID

sp_appid

string[1,32]

是

服務商申請的公眾號或移動應用appid。
示例值：wx8888888888888888

服務商戶號

sp_mchid

string[1,32]

是

服務商戶號，由微信支付生成并下發(fā)
示例值：1230000109

子商戶公眾號ID

sub_appid

string[1,32]

否

子商戶申請的公眾號或移動應用appid。如果返回sub_appid，那么sub_openid一定會返回。
示例值：wxd678efh567hg6999

子商戶號

sub_mchid

string[1,32]

是

子商戶的商戶號，有微信支付生成并下發(fā)。
示例值：1900000109

商戶訂單號

out_trade_no

string[1,32]

是

商戶系統(tǒng)內部訂單號，只能是數字、大小寫字母_-*且在同一個商戶號下唯一，詳見【商戶訂單號】。
特殊規(guī)則：最小字符長度為6
示例值：1217752501201407033233368018

微信支付訂單號

transaction_id

string[1,32]

否

微信支付系統(tǒng)生成的訂單號。
示例值：1217752501201407033233368018

交易類型

trade_type

string[1,16]

否

交易類型，枚舉值：
JSAPI：公眾號支付
NATIVE：掃碼支付
APP：APP支付
MICROPAY：付款碼支付
MWEB：H5支付
FACEPAY：刷臉支付
示例值：MICROPAY

交易狀態(tài)

trade_state

string[1,32]

是

交易狀態(tài)，枚舉值：
SUCCESS：支付成功
REFUND：轉入退款
NOTPAY：未支付
CLOSED：已關閉
REVOKED：已撤銷（付款碼支付）
USERPAYING：用戶支付中（付款碼支付）
PAYERROR：支付失敗(其他原因，如銀行返回失敗)
示例值：SUCCESS

交易狀態(tài)描述

trade_state_desc

string[1,256]

是

交易狀態(tài)描述
示例值：支付失敗，請重新下單支付

付款銀行

bank_type

string[1,32]

否

銀行類型，采用字符串類型的銀行標識。
示例值：CMC

附加數據

attach

string[1,128]

否

附加數據，在查詢API和支付通知中原樣返回，可作為自定義參數使用
示例值：自定義數據 ?

支付完成時間

success_time

string[1,64]

否

支付完成時間，遵循rfc3339標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示，北京時間2015年5月20日 13點29分35秒。
示例值：2018-06-08T10:34:56+08:00

+ 支付者

payer

object

是

支付者信息

參數名	變量	類型[長度限制]	必填	描述
用戶服務標識	sp_openid	string[1,128]	是	用戶在服務商appid下的唯一標識。示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶子標識	sub_openid	string[1,128]	否	用戶在子商戶appid下的唯一標識。如果返回sub_appid，那么sub_openid一定會返回。示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

+訂單金額

amount

object

否

訂單金額信息，當支付成功時返回該字段。

參數名	變量	類型[長度限制]	必填	描述
總金額	total	int	否	訂單總金額，單位為分。示例值：100
用戶支付金額	payer_total	int	否	用戶支付金額，單位為分。示例值：100
貨幣類型	currency	string[1,16]	否	CNY：人民幣，境內商戶號僅支持人民幣。示例值：CNY
用戶支付幣種	payer_currency	string[1,16]	否	用戶支付幣種示例值：CNY

+場景信息

scene_info

object

否

支付場景描述

參數名	變量	類型[長度限制]	必填	描述
商戶端設備號	device_id	string[1,32]	否	商戶端設備號（發(fā)起扣款請求的商戶服務器設備號）。示例值：013467007045764

+優(yōu)惠功能

promotion_detail

array

否

優(yōu)惠功能，享受優(yōu)惠時返回該字段。

參數名

變量

類型[長度限制]

必填

描述

券ID

coupon_id

string[1,32]

是

券ID
示例值：109519

優(yōu)惠名稱

name

string[1,64]

否

優(yōu)惠名稱
示例值：單品惠-6

優(yōu)惠范圍

scope

string[1,32]

否

GLOBAL：全場代金券
SINGLE：單品優(yōu)惠
示例值：GLOBAL

優(yōu)惠類型

type

string[1,32]

否

CASH：充值型代金券
NOCASH：免充值型代金券
示例值：CASH

優(yōu)惠券面額

amount

int

是

優(yōu)惠券面額
示例值：100

活動ID

stock_id

string[1,32]

否

活動ID
示例值：931386

微信出資

wechatpay_contribute

int

否

微信出資，單位為分
示例值：0

商戶出資

merchant_contribute

int

否

商戶出資，單位為分
示例值：0

其他出資

other_contribute

int

否

其他出資，單位為分
示例值：0

優(yōu)惠幣種

currency

string[1,16]

否

CNY：人民幣，境內商戶號僅支持人民幣。
示例值：CNY

+單品列表

goods_detail

array

否

單品列表信息

參數名	變量	類型[長度限制]	必填	描述
商品編碼	goods_id	string[1,32]	是	商品編碼示例值：M1006
商品數量	quantity	int	是	用戶購買的數量示例值：1
商品單價	unit_price	int	是	商品單價，單位為分示例值：100
商品優(yōu)惠金額	discount_amount	int	是	商品優(yōu)惠金額示例值：0 ?
商品備注	goods_remark	string[1,128]	否	商品備注信息示例值：商品備注信息

返回示例

正常示例


{
	"transaction_id": "1217752501201407033233368018",
	"amount": {
		"payer_total": 100,
		"total": 100,
		"currency": "CNY",
		"payer_currency": "CNY"
	},
	"trade_state": "SUCCESS",
	"bank_type": "CMC",
	"promotion_detail": [{
		"amount": 100,
		"wechatpay_contribute": 0,
		"coupon_id": "109519",
		"scope": "GLOBALSINGLE",
		"merchant_contribute": 0,
		"name": "單品惠-6",
		"other_contribute": 0,
		"currency": "CNY",
		"type": "CASHNOCASH",
		"stock_id": "931386",
		"goods_detail": [{
			"goods_remark": "商品備注信息",
			"quantity": 1,
			"discount_amount": 1,
			"goods_id": "M1006",
			"unit_price": 100
		}, {
			"goods_remark": "商品備注信息",
			"quantity": 1,
			"discount_amount": 1,
			"goods_id": "M1006",
			"unit_price": 100
		}]
	}, {
		"amount": 100,
		"wechatpay_contribute": 0,
		"coupon_id": "109519",
		"scope": "GLOBALSINGLE",
		"merchant_contribute": 0,
		"name": "單品惠-6",
		"other_contribute": 0,
		"currency": "CNY",
		"type": "CASHNOCASH",
		"stock_id": "931386",
		"goods_detail": [{
			"goods_remark": "商品備注信息",
			"quantity": 1,
			"discount_amount": 1,
			"goods_id": "M1006",
			"unit_price": 100
		}, {
			"goods_remark": "商品備注信息",
			"quantity": 1,
			"discount_amount": 1,
			"goods_id": "M1006",
			"unit_price": 100
		}]
	}],
	"sp_mchid": "1230000109",
	"success_time": "2018-06-08T10:34:56+08:00",
	"sub_appid": "wxd678efh567hg6999",
	"payer": {
		"sp_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
		"sub_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
	},
	"sp_appid": "wx8888888888888888",
	"out_trade_no": "1217752501201407033233368018",
	"trade_state_desc": "支付失敗，請重新下單支付",
	"trade_type": "MICROPAY",
	"sub_mchid": "1900000109",
	"attach": "自定義數據",
	"scene_info": {
		"device_id": "013467007045764"
	}
}


    http://2323weixin.qq.com

錯誤碼公共錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
202	USERPAYING	用戶支付中，需要輸入密碼	等待5秒，然后調用被掃訂單結果查詢API，查詢當前訂單的不同狀態(tài)，決定下一步的操作
403	TRADE_ERROR	交易錯誤	因業(yè)務原因交易失敗，請查看接口返回的詳細信息
500	SYSTEMERROR	系統(tǒng)錯誤	系統(tǒng)異常，請用相同參數重新調用
401	SIGN_ERROR	簽名錯誤	請檢查簽名參數和方法是否都符合簽名算法要求
403	RULELIMIT	業(yè)務規(guī)則限制	因業(yè)務規(guī)則限制請求頻率，請查看接口返回的詳細信息
400	PARAM_ERROR	參數錯誤	請根據接口返回的詳細信息檢查請求參數
403	OUT_TRADE_NO_USED	商戶訂單號重復	請核實商戶訂單號是否重復提交
404	ORDERNOTEXIST	訂單不存在	請檢查訂單是否發(fā)起過交易
400	ORDER_CLOSED	訂單已關閉	當前訂單已關閉，請重新下單
500	OPENID_MISMATCH	openid和appid不匹配	請確認openid和appid是否匹配
403	NOTENOUGH	余額不足	用戶賬號余額不足，請用戶充值或更換支付卡后再支付
403	NOAUTH	商戶無權限	請商戶前往申請此接口相關權限
400	MCH_NOT_EXISTS	商戶號不存在	請檢查商戶號是否正確
500	INVALID_TRANSACTIONID	訂單號非法	請檢查微信支付訂單號是否正確
400	INVALID_REQUEST	無效請求	請根據接口返回的詳細信息檢查
429	FREQUENCY_LIMITED	頻率超限	請降低請求接口頻率
500	BANKERROR	銀行系統(tǒng)異常	銀行系統(tǒng)異常，請用相同參數重新調用
400	APPID_MCHID_NOT_MATCH	appid和mch_id不匹配	請確認appid和mch_id是否匹配
403	ACCOUNTERROR	賬號異常	用戶賬號異常，無需更多操作

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

微信支付商戶平臺

普通支付（服務商模式）API文檔

查詢訂單API

注意：

1、微信支付訂單號查詢

接口說明

請求參數

請求示例

2、商戶訂單號查詢

接口說明

請求參數

請求示例

返回參數

返回示例

錯誤碼公共錯誤碼

版本說明