微信支付境外文檔-委托代扣

返回上一層委托代扣 / 查詢訂單API

查詢訂單API

微信訂單號查詢訂單API

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

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

接口說明

適用對象：直連模式機構(gòu)模式

接口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

接口規(guī)則：https://wechatpay-api.gitbook.io/wechatpay-api-v3/

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

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

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

請求參數(shù)

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

返回參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

商戶號

mchid

string[1,32]

是

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

應(yīng)用ID

appid

string[1,32]

是

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

服務(wù)商商戶號

sp_mchid

string[1,32]

是

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

子商戶號

sub_mchid

string[1,32]

是

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

服務(wù)商應(yīng)用ID

sp_appid

string[1,32]

是

服務(wù)商綁定的appid
注意：僅適用于機構(gòu)模式
示例值：wxcbda96de0b165486

子商戶應(yīng)用ID

sub_appid

string[1,32]

否

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

商戶訂單號

out_trade_no

string[1,32]

是

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

微信支付訂單號

transaction_id

string[1,32]

是

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

商戶數(shù)據(jù)

attach

string[1,127]

否

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

交易類型

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：轉(zhuǎn)入退款
NOTPAY：未支付
CLOSED：已關(guān)閉
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
用戶標識（服務(wù)商）	sp_openid	string[1,128]	是	用戶在商戶sp_appid對應(yīng)下的唯一標識，需要傳sp_appid才有返回注意：僅適用于機構(gòu)模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶標識（特約商戶）	sub_openid	string[1,128]	否	用戶在收單行sub_appid下用戶唯一標識，需要傳sub_appid才有返回注意：僅適用于機構(gòu)模式示例值：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

否

匯率信息

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

+場景信息

scene_info

object

否

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

參數(shù)名	變量	類型[長度限制]	必填	描述
商戶端設(shè)備	device_id	string[1,32]	否	終端設(shè)備號(商戶自定義，如門店編號) 示例值：013467007045764
商戶端設(shè)備IP	device_ip	string[1,40]	否	商戶側(cè)設(shè)備IP，取公網(wǎng)出口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：代金券，需要走結(jié)算資金的充值型代金券,（境外商戶券幣種與支付幣種一致）
DISCOUNT：優(yōu)惠券，不走結(jié)算資金的免充值型優(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

否

單品信息

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

返回示例

正常示例


{
  "mchid": "10000091",
  "appid": "wxcbda96de0b165486",
  "sp_mchid": "10000098",
  "sub_mchid": "10000097",
  "sp_appid": "wxcbda96de0b165486",
  "sub_appid": "wxcbda96de0b165484",
  "out_trade_no": "1217752501201407033233368018",
  "transaction_id": "1217752501201407033233368018",
  "attach": "自定義數(shù)據(jù)",
  "trade_type": "AUTH",
  "bank_type": "WPHK：香港錢包支付",
  "success_time": "2018-06-08T10:34:56+08:00",
  "trade_state": "SUCCESS",
  "trade_state_desc": "支付失敗，請重新下單支付",
  "merchant_category_code": "1011",
  "payer": {
    "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6a",
    "sp_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
    "sub_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
  },
  "amount": {
    "total": 888,
    "payer_total": 888,
    "currency": "CNY",
    "payer_currency": "HKD",
    "exchange_rate": {
      "type": "SETTLEMENT_RATE",
      "rate": 80000000
    }
  },
  "scene_info": {
    "device_id": "013467007045764",
    "device_ip": "128.0.0.1"
  },
  "promotion_detail": [
    {
      "promotion_id": "109519",
      "name": "單品惠-6",
      "scope": "SINGLE",
      "type": "COUPON",
      "amount": 5,
      "currency": "HKD",
      "activity_id": "931386",
      "wxpay_contribute_amount": 100,
      "merchant_contribute_amount": 100,
      "other_contribute_amount": 5,
      "goods_detail": {
        "goods_id": "1245454",
        "goods_remark": "1001",
        "discount_amount": 100,
        "quantity": 1,
        "price": 528800
      }
    }
  ]
}


http://2323weixin.qq.com

錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
400	PARAM_ERROR	參數(shù)錯誤	請檢查參數(shù)格式是否符合協(xié)議規(guī)范
404	NOT_FOUND	交易訂單號不存在	建議確認訂單號和商戶號正確之后再查詢
500	SYSTEM_ERROR	系統(tǒng)錯誤	系統(tǒng)異常，請重試查詢
400	ORDER_CLOSED	訂單已關(guān)閉	支付失敗，請重新下單支付

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

委托代扣API

查詢訂單API

微信訂單號查詢訂單API

接口說明

請求參數(shù)

請求示例

返回參數(shù)

返回示例

錯誤碼

版本說明