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

商戶進件
特約商戶進件
基礎支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合單支付
付款碼支付
經(jīng)營能力
支付即服務
點金計劃
行業(yè)方案
平臺收付通（商戶進件）
平臺收付通（普通支付）
平臺收付通（合單支付）
平臺收付通（分賬）
平臺收付通（補差）
平臺收付通（退款）
平臺收付通（余額查詢）
平臺收付通（商戶提現(xiàn)）
平臺收付通（注銷申請）
平臺收付通（注銷后提現(xiàn)）
平臺收付通（跨境付款）
平臺收付通（下載賬單）
智慧商圈
微信支付分停車服務
電子發(fā)票
營銷工具
代金券
商家券
委托營銷
支付有禮
小程序發(fā)券插件
H5發(fā)券
圖片上傳(營銷專用)
現(xiàn)金紅包
資金應用
分賬
連鎖品牌分賬
風險合規(guī)
商戶開戶意愿確認
消費者投訴2.0
商戶違規(guī)通知回調(diào)
其他能力
圖片上傳
視頻上傳
微信支付平臺證書

查詢訂單API

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


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


注意：

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


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

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

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

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

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


1、微信支付訂單號查詢

接口說明

適用對象： 服務商

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

請求方式：GET


path指該參數(shù)為路徑參數(shù)

query指該參數(shù)需在請求URL傳參

body指該參數(shù)需在請求JSON傳參


請求參數(shù)

參數(shù)名 變量 類型[長度限制] 必填 描述
服務商戶號 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/4200000985202103031441826014?sp_mchid=1900007XXX&sub_mchid=1900008XXX

    
｛
JAVA示例代碼
｝

2、商戶訂單號查詢

接口說明

適用對象： 服務商

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

請求方式：GET


path指該參數(shù)為路徑參數(shù)

query指該參數(shù)需在請求URL傳參

body指該參數(shù)需在請求JSON傳參


請求參數(shù)

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

請求示例


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

    
｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名 變量 類型[長度限制] 必填 描述
服務商應用ID sp_appid string[1,32] 是 服務商申請的公眾號或移動應用appid。
示例值：wx8888888888888888
服務商戶號 sp_mchid string[1,32] 是 服務商戶號，由微信支付生成并下發(fā)
示例值：1230000109
子商戶應用ID sub_appid string[1,32] 否 子商戶申請的公眾號或移動應用appid。
示例值：wxd678efh567hg6999
子商戶號 sub_mchid string[1,32] 是 子商戶的商戶號，由微信支付生成并下發(fā)。
示例值：1900000109
商戶訂單號 out_trade_no string[6,32] 是 商戶系統(tǒng)內(nèi)部訂單號，只能是數(shù)字、大小寫字母_-*且在同一個商戶號下唯一，詳見【商戶訂單號】。
特殊規(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
附加數(shù)據(jù) attach string[1,128] 否 附加數(shù)據(jù)，在查詢API和支付通知中原樣返回，可作為自定義參數(shù)使用，實際情況下只有支付完成狀態(tài)才會返回該字段。
示例值：自定義數(shù)據(jù) ?
支付完成時間 success_time string[1,64] 否 支付完成時間，遵循rfc3339標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示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 是 支付者信息
參數(shù)名 變量 類型[長度限制] 必填 描述
用戶服務標識 sp_openid string[1,128] 是 用戶在服務商appid下的唯一標識。
示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶子標識 sub_openid string[1,128] 否 用戶在子商戶appid下的唯一標識。如果返回sub_appid，那么sub_openid一定會返回
示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
+訂單金額 amount object 否 訂單金額信息，當支付成功時返回該字段。
參數(shù)名 變量 類型[長度限制] 必填 描述
總金額 total int 否 訂單總金額，單位為分。
示例值：100
用戶支付金額 payer_total int 否 用戶支付金額，單位為分。（指使用優(yōu)惠券的情況下，這里等于總金額-優(yōu)惠券金額）
示例值：100
貨幣類型 currency string[1,16] 否 CNY：人民幣，境內(nèi)商戶號僅支持人民幣。
示例值：CNY
用戶支付幣種 payer_currency string[1,16] 否 用戶支付幣種
示例值：CNY
+場景信息 scene_info object 否 支付場景描述
參數(shù)名 變量 類型[長度限制] 必填 描述
商戶端設備號 device_id string[1,32] 否 商戶端設備號（發(fā)起扣款請求的商戶服務器設備號）。
示例值：013467007045764
+優(yōu)惠功能 promotion_detail array 否 優(yōu)惠功能，享受優(yōu)惠時返回該字段。
參數(shù)名 變量 類型[長度限制] 必填 描述
券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：人民幣，境內(nèi)商戶號僅支持人民幣。
示例值：CNY
+單品列表 goods_detail array 否 單品列表信息
參數(shù)名 變量 類型[長度限制] 必填 描述
商品編碼 goods_id string[1,32] 是 商品編碼
示例值：M1006
商品數(shù)量 quantity int 是 用戶購買的數(shù)量
示例值：1
商品單價 unit_price int 是 商品單價，單位為分
示例值：100
商品優(yōu)惠金額 discount_amount int 是 商品優(yōu)惠金額
示例值：0 ?
商品備注 goods_remark string[1,128] 否 商品備注信息
示例值：商品備注信息

返回示例


{
	"amount": {
		"currency": "CNY",
		"payer_currency": "CNY",
		"payer_total": 2,
		"total": 2
	},
	"attach": "",
	"bank_type": "CMB_DEBIT",
	"out_trade_no": "b3682ea011c547a49e8d7cc93107b71c",
	"payer": {
		"sp_openid": "o4GgauMQHaUO8ujCGIXNKATQlXXX",
		"sub_openid": "o4GgauMQHaUO8ujCGIXNKATQlXXX"
	},
	"promotion_detail": [],
	"sp_appid": "wxdace645e0bc2cXXX",
	"sp_mchid": "1900007XXX",
	"sub_appid": "wxdace645e0bc2cXXX",
	"sub_mchid": "1900008XXX",
	"success_time": "2021-03-03T15:27:14+08:00",
	"trade_state": "SUCCESS",
	"trade_state_desc": "支付成功",
	"trade_type": "JSAPI",
	"transaction_id": "4200000985202103031441826014"
}
                                

    http://2323weixin.qq.com

錯誤碼公共錯誤碼

狀態(tài)碼 錯誤碼 描述 解決方案
400 INVALID_REQUEST 無效請求 請根據(jù)接口返回的詳細信息檢查
APPID_MCHID_NOT_MATCH appid和mch_id不匹配 請確認appid和mch_id是否匹配
PARAM_ERROR 參數(shù)錯誤 請根據(jù)接口返回的詳細信息檢查請求參數(shù)
ORDER_CLOSED 訂單已關閉 當前訂單已關閉，請重新下單
MCH_NOT_EXISTS 商戶號不存在 請檢查商戶號是否正確
401 SIGN_ERROR 簽名錯誤 請檢查簽名參數(shù)和方法是否都符合簽名算法要求
403 ACCOUNT_ERROR 賬號異常 用戶賬號異常，無需更多操作
OUT_TRADE_NO_USED 商戶訂單號重復 請核實商戶訂單號是否重復提交
TRADE_ERROR 交易錯誤 因業(yè)務原因交易失敗，請查看接口返回的詳細信息
RULE_LIMIT 業(yè)務規(guī)則限制 因業(yè)務規(guī)則限制請求頻率，請查看接口返回的詳細信息
NOT_ENOUGH 余額不足 用戶賬號余額不足，請用戶充值或更換支付卡后再支付
NO_AUTH 商戶無權限 請商戶前往申請此接口相關權限
404 ORDER_NOT_EXIST 訂單不存在 請檢查訂單是否發(fā)起過交易
ORDER_NOT_EXIST 訂單不存在 請檢查訂單是否發(fā)起過交易
429 FREQUENCY_LIMITED 頻率超限 請降低請求接口頻率
500 SYSTEM_ERROR 系統(tǒng)錯誤 系統(tǒng)異常，請用相同參數(shù)重新調(diào)用
OPENID_MISMATCH openid和appid不匹配 請確認openid和appid是否匹配
INVALID_TRANSACTIONID 訂單號非法 請檢查微信支付訂單號是否正確
BANK_ERROR 銀行系統(tǒng)異常 銀行系統(tǒng)異常，請用相同參數(shù)重新調(diào)用


技術咨詢

文檔反饋