API字典 / 委托代扣 / 查詢訂單API

查詢訂單API

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

該接口提供所有微信支付訂單的查詢，商戶可以通過查詢訂單接口主動查詢訂單狀態(tài)，完成下一步的業(yè)務邏輯。
需要調用查詢接口的情況：
1. 當商戶后臺、網絡、服務器等出現(xiàn)異常，商戶系統(tǒng)最終未接收到支付通知；
2. 調用扣款接口后，返回系統(tǒng)錯誤或未知交易狀態(tài)情況

注意：

? 商戶上送敏感信息時使用微信支付平臺公鑰加密，證書序列號包含在請求HTTP頭部的Wechatpay-Serial，詳見接口規(guī)則

1. 接口說明

適用對象： 直連模式機構模式

請求URL：https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/{transaction_id}
或
https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/out-trade-no/{out_trade_no}

請求方式：GET

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

Query指該參數(shù)為URL參數(shù)

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

2. 請求參數(shù)

參數(shù)名	變量	類型[長度限制]	必填	描述
子商戶號	sub_mchid	string[1,32]	否	Query服務商模式必填，微信支付分配的子商戶號注意：僅適用于機構模式示例值：10000097
微信訂單號	transaction_id	string[1,32]	二選一	Path支付完成后，微信返回的微信支付訂單號示例值：4015463511252015071056489715
商戶訂單號	out_trade_no	string[1,32]	二選一	Path商戶系統(tǒng)內部的訂單號，可包含字母；更換授權碼必須要換新的商戶訂單號其他說明見商戶訂單號示例值：1217752501201407033233368018

請求示例

場景一：直連模式場景二：服務商模式/機構模式

https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/4015463511252015071056489715
或
https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/out_trade_no/1217752501201407033233368018

https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/4015463511252015071056489715?sub_mchid=10000097
或
https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/out_trade_no/1217752501201407033233368018?sub_mchid=10000097

3. 返回參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

商戶號

mchid

string[1,32]

是

微信支付分配的商戶號
注意：僅適用于直連模式
示例值：10000091

應用ID

appid

string[1,32]

是

商戶號綁定的appid
注意：僅適用于直連模式
示例值：wxcbda96de0b165486

服務商商戶號

sp_mchid

string[1,32]

是

微信支付分配的機構商戶號
注意：僅適用于機構模式
示例值：10000098

子商戶號

sub_mchid

string[1,32]

是

微信支付分配的子商戶號
注意：僅適用于機構模式
示例值：10000097

服務商應用ID

sp_appid

string[1,32]

是

服務商綁定的appid
注意：僅適用于機構模式
示例值：wxcbda96de0b165486

子商戶應用ID

sub_appid

string[1,32]

否

發(fā)起簽約的子商戶號綁定的appid
注意：僅適用于機構模式
示例值：wxcbda96de0b165484

商戶訂單號

out_trade_no

string[1,32]

是

返回的商戶訂單號
示例值：1217752501201407033233368018

微信支付訂單號

transaction_id

string[1,32]

是

微信支付訂單號
示例值：1217752501201407033233368018

商戶數(shù)據

attach

string[1,127]

否

附加數(shù)據，在查詢API和支付通知中原樣返回，該字段主要用于商戶攜帶訂單的自定義數(shù)據
示例值：自定義數(shù)據

交易類型

trade_type

string[1,16]

是

代扣支付
示例值：AUTH

付款銀行

bank_type

string[1,32]

否

銀行類型
示例值：WPHK：香港錢包支付

支付完成時間

success_time

string[1,64]

是

支付完成時間，格式為rfc3339格式，如2018-06-08T10:34:56+08:00 代表北京時間2018年06月08日10時34分56秒
示例值：2018-06-08T10:34:56+08:00

交易狀態(tài)

trade_state

string[1,16]

是

枚舉值：
SUCCESS：支付成功
REFUND：轉入退款
NOTPAY：未支付
CLOSED：已關閉
PAYERROR：支付失敗
USERPAYING：用戶支付中
示例值：SUCCESS

交易狀態(tài)描述

trade_state_desc

string[1,256]

是

對當前訂單狀態(tài)的描述和下一步操作的指引
示例值：支付失敗，請重新下單支付

MCC碼

merchant_category_code

string[1,16]

是

商戶行業(yè)編碼
示例值：1011

支付者

payer

object

否

成功時才返回。支付者信息，詳細說明見下文

參數(shù)名	變量	類型[長度限制]	必填	描述
用戶標識（直連商戶）	openid	string[1,128]	是	用戶在商戶appid下的openid 注意：僅適用于直連模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6a
用戶標識（服務商）	sp_openid	string[1,128]	是	用戶在商戶sp_appid對應下的唯一標識，需要傳sp_appid才有返回注意：僅適用于機構模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶標識（子商戶）	sub_openid	string[1,128]	否	用戶在收單行sub_appid下用戶唯一標識，需要傳sub_appid才有返回注意：僅適用于機構模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

收起

訂單金額

amount

object

否

成功時才返回。訂單金額信息，詳細說明見下文

參數(shù)名

變量

類型[長度限制]

必填

描述

訂單金額

total

int

是

訂單總金額，幣種的最小單位，只能為整數(shù)，詳見交易金額
示例值：888

用戶支付金額

payer_total

int

是

用戶實際支付金額，幣種的最小單位，只能為整數(shù)，詳見交易金額
示例值：888

訂單標價幣種

currency

string[1,16]

是

符合ISO 4217標準的三位字母代碼
示例值：CNY

用戶支付幣種

payer_currency

string[1,16]

否

符合ISO 4217標準的三位字母代碼
示例值：HKD

匯率信息

exchange_rate

object

否

Body匯率信息

參數(shù)名	變量	類型[長度限制]	必填	描述
匯率類型	type	string[1,16]	否	枚舉值： SETTLEMENT_RATE：標價幣種和結算幣種的匯率類型 USERPAYMENT_RATE：標價幣種和支付幣種的匯率類型示例值：SETTLEMENT_RATE
匯率值	rate	int	否	rate值是兌換比例乘以10的8次方。如果標價幣種和結算幣種一致，兌換比例是1，則rate=100000000；如果標價幣種和結算幣種不一致，例如美元兌換人民幣的比例為6.5，則rate=650000000 示例值：80000000

收起

場景信息

scene_info

object

否

成功時才返回。場景信息對象，詳細說明見下文

參數(shù)名	變量	類型[長度限制]	必填	描述
商戶端設備	device_id	string[1,32]	否	終端設備號(商戶自定義，如門店編號) 示例值：013467007045764
商戶端設備IP	device_ip	string[1,40]	否	商戶側設備IP，取公網出口IP，支持IPV6 示例值：128.0.0.1

收起

優(yōu)惠功能

promotion_detail

array

否

成功時才返回。優(yōu)惠功能信息，詳細說明見下文

參數(shù)名

變量

類型[長度限制]

必填

描述

券ID

promotion_id

string[1,32]

是

券或者立減優(yōu)惠id
示例值：109519

優(yōu)惠名稱

name

string[1,64]

否

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

優(yōu)惠范圍

scope

string[1,32]

否

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

優(yōu)惠類型

type

string[1,16]

否

COUPON：代金券，需要走結算資金的充值型代金券,（境外商戶券幣種與支付幣種一致）
DISCOUNT：優(yōu)惠券，不走結算資金的免充值型優(yōu)惠券，（境外商戶券幣種與標價幣種一致
示例值：COUPON

優(yōu)惠券面額

amount

int

是

用戶享受優(yōu)惠的金額
示例值：5

優(yōu)惠幣種

currency

string[1,16]

是

符合ISO 4217標準的三位字母代碼
示例值：HKD

活動ID

activity_id

string[1,32]

否

在微信商戶后臺配置的批次ID
示例值：931386

微信出資

wxpay_contribute_amount

int

否

特指由微信支付商戶平臺創(chuàng)建的優(yōu)惠，出資金額等于本項優(yōu)惠總金額
示例值：5

商戶出資

merchant_contribute_amount

int

否

特指商戶自己創(chuàng)建的優(yōu)惠，出資金額等于本項優(yōu)惠總金額
示例值：5

其他出資

other_contribute_amount

int

否

其他出資方出資金額
示例值：5

單品列表

goods_detail

array

否

Body成功時才返回。優(yōu)惠功能信息，詳細說明見下文

參數(shù)名	變量	類型[長度限制]	必填	描述
商品編碼	goods_id	string[1,32]	是	由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成示例值：124512
商品備注	goods_remark	string[1,128]	否	goods_remark為備注字段，按照配置原樣返回，字段內容在微信后臺配置券時進行設置示例值：1001
商品優(yōu)惠金額	discount_amount	int	是	單品的總優(yōu)惠金額示例值：100
商品數(shù)量	quantity	int	是	用戶購買的數(shù)量示例值：1
商品價格	price	int	是	單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價示例值：528800

收起

4. 錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
403	CONTRACT_NOT_EXIST	Result Empty	查詢的簽約協(xié)議不存在，或者傳入正確查詢參數(shù)重試
400	PARAM_ERROR	參數(shù)錯誤	傳入正確查詢參數(shù)
500	SYSTEM_ERROR	系統(tǒng)錯誤	請稍等重試

語言

頁面導航

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產品

資金類產品

其他產品

查詢訂單API

1. 接口說明

2. 請求參數(shù)

請求示例

3. 返回參數(shù)

4. 錯誤碼

版本說明