微信支付境外文檔-報(bào)關(guān)

返回上一層報(bào)關(guān) / 報(bào)關(guān)查詢API

報(bào)關(guān)查詢API

最新更新時(shí)間：2020.04.03 版本說明

商戶通過訂單號(hào)查詢提交的訂單附加信息及訂單報(bào)關(guān)狀態(tài)。

接口說明

適用對(duì)象：直連模式

接口URL：https://apihk.mch.weixin.qq.com/global/v3/customs /orders

請(qǐng)求方式：GET

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

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

參數(shù)名	變量	類型	必填	描述
機(jī)構(gòu)APPID	appid	string(32)	是	微信分配的公眾賬號(hào)ID 示例值：wxd678efh567hg6787
商戶號(hào)	mchid	string(32)	是	微信支付分配的商戶號(hào) 示例值：1230000109
訂單類型	order_type	string(16)	是	4種訂單號(hào)類型，選擇一種 out_trade_no???商戶訂單號(hào) transaction_id??微信支付訂單號(hào) sub_order_no??商戶子訂單號(hào) sub_order_id??微信子訂單號(hào) 示例值：out_trade_no
訂單號(hào)	order_no	string(32)	是	根據(jù)訂單號(hào)類型，傳入不同的訂單號(hào)碼示例值：20150806125346
海關(guān)	customs	string(32)	是	海關(guān)代碼，枚舉值參見參數(shù)規(guī)定-海關(guān)列表示例值：SHANGHAI_ZS
偏移量	offset	int	否	非0整數(shù)，該次請(qǐng)求資源的起始位置，從0開始計(jì)數(shù)。調(diào)用方選填，默認(rèn)為0 示例值：1
請(qǐng)求最大記錄條數(shù)	limit	int	否	非0非負(fù)的整數(shù)，該次請(qǐng)求可返回的最大資源條數(shù)。調(diào)用方選填，默認(rèn)值建議為20 示例值：20

請(qǐng)求示例：

JSON

{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "out_trade_no": "20150806125346",
  "transaction_id": "1000320306201511078440737890",
  "sub_order_no": "20150806125346",
  "customs": "SHANGHAI_ZS",
  "merchant_customs_no": "123456",
  "certificate_type": "IDCARD",
  "certificate_id": "330821198809085211",
  "certificate_name": "張三"
}

    
｛
JAVA示例代碼
｝

對(duì)于加密字段，請(qǐng)參照以下加密算法：

1、獲取微信支付平臺(tái)證書和對(duì)應(yīng)的平臺(tái)證書序列號(hào)，本接口請(qǐng)求 http 頭的“Wechatpay-Serial”需要傳平臺(tái)證書序列號(hào)。

2、使用微信支付平臺(tái)證書的公鑰，對(duì)于需要加密的參數(shù)值進(jìn)行 RSA 加密。填充方案使用 `RSAES-PKCS1-v1_5`。

3、加密后的密文，使用 base64 編碼后，作為請(qǐng)求中相應(yīng)參數(shù)的值。

返回參數(shù)

正常返回

參數(shù)名

變量

類型

必填

描述

機(jī)構(gòu)APPID

appid

string(32)

是

微信分配的公眾賬號(hào)ID
示例值：wxd678efh567hg6787

商戶號(hào)

mchid

string(32)

是

微信支付分配的商戶號(hào)
示例值：1230000109

微信訂單號(hào)

transaction_id

string(32)

是

微信支付返回的訂單號(hào)
示例值：1000320306201511078440737890

核驗(yàn)機(jī)構(gòu)

verify_department

string(16)

是

核驗(yàn)機(jī)構(gòu)代碼
UNIONPAY：銀聯(lián)
NETSUNION：網(wǎng)聯(lián)
OTHERS：其他
示例值：UNIONPAY

核驗(yàn)機(jī)構(gòu)流水號(hào)

verify_department_trade_id

string(64)

是

交易流水號(hào)，來自驗(yàn)核機(jī)構(gòu)，如銀聯(lián)記錄的交易流水號(hào)，供商戶報(bào)備海關(guān)
示例值：2018112288340107038204310100000

偏移量

offset

int

是

返回請(qǐng)求時(shí)設(shè)置的偏移值
示例值：0

請(qǐng)求最大記錄條數(shù)

limit

int

是

返回請(qǐng)求時(shí)設(shè)置的最大記錄數(shù)
示例值：20

查詢結(jié)果總條數(shù)

total_count

int

是

查詢結(jié)果總條數(shù)
示例值：1

+報(bào)關(guān)數(shù)據(jù)包

data

array

是

報(bào)關(guān)單結(jié)果數(shù)組，具體內(nèi)容參見下方描述
示例值：

參數(shù)名	變量	類型	必填	描述
商戶子單號(hào)	sub_order_no	string(32)	否	商戶子訂單號(hào) 示例值：20150806125346
微信子單號(hào)	sub_order_id	string(32)	否	微信子訂單號(hào) 示例值：20150806125346
商戶海關(guān)備案號(hào)	mch_customs_no	string(32)	否	商戶在海關(guān)登記的備案號(hào) 示例值：1234567
海關(guān)代碼	customs	string(32)	是	海關(guān)代碼，詳情參考章節(jié)3.5.10 示例值：SHANGHAI_ZS
幣種	fee_type	string(3)	否	固定值CNY 示例值：CNY
子單金額	order_fee	int	否	子單金額，以分為單位示例值：888
關(guān)稅	duty	int	否	關(guān)稅，以分為單位，非必填項(xiàng)，不會(huì)提交給海關(guān) 示例值：888
物流費(fèi)用	transport_fee	int	否	物流費(fèi)用，以分為單位示例值：888
商品費(fèi)用	product_fee	int	否	商品費(fèi)用，以分為單位示例值：888
報(bào)關(guān)狀態(tài)	state	string(32)	是	申報(bào)結(jié)果狀態(tài)碼 PROCESSING：申報(bào)中 UNDECLARED：未申報(bào) SUBMITTED：已修改未申報(bào) SUCCESS：申報(bào)成功 FAIL：申報(bào)失敗 EXCEPT：海關(guān)接口異常示例值：PROCESSING
報(bào)關(guān)結(jié)果說明	explanation	string(128)	否	申報(bào)結(jié)果說明，如果狀態(tài)是失敗或異常，顯示失敗原因示例值：支付單已存在并且為非退單狀態(tài)
最后更新時(shí)間	modify_time	string(32)	是	最后更新時(shí)間，該時(shí)間取自微信服務(wù)器示例值：2015-09-01T10:00:00+08:00

異常返回

參數(shù)名

變量

類型

必填

描述

返回狀態(tài)碼

code

string（32）

是

錯(cuò)誤碼，枚舉值見錯(cuò)誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string（256）

是

返回信息，如非空，為錯(cuò)誤原因
示例值：參數(shù)格式校驗(yàn)錯(cuò)誤

+詳細(xì)錯(cuò)誤描述

detail

object

否

當(dāng)code為PARAM_ERROR時(shí)返回，詳細(xì)說明見下文

參數(shù)名	變量	類型	必填	描述
指示錯(cuò)誤參數(shù)的字段	field	string(256)	是	當(dāng)錯(cuò)誤參數(shù)位于請(qǐng)求 body 的 JSON 時(shí) 填寫指向參數(shù)的 JSON Pointer; 當(dāng)錯(cuò)誤參數(shù)位于請(qǐng)求的 url 或者 querystring 時(shí)，填寫參數(shù)的變量名示例值：#/properties/payer
錯(cuò)誤參數(shù)的值	value	string(256)	是	錯(cuò)誤參數(shù)的值示例值：1346177081915535577
具體錯(cuò)誤原因	issue	string(256)	是	具體錯(cuò)誤原因示例值：與 ALLOF schema 不符
錯(cuò)誤參數(shù)的位置	location	string(256)	否	body:錯(cuò)誤參數(shù)位于請(qǐng)求 body 的 JSON 中 url:錯(cuò)誤參數(shù)位于請(qǐng)求 url 中 query:錯(cuò)誤參數(shù)位于請(qǐng)求的 querystring 中示例值：body

返回示例：

正常示例

{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "transaction_id": "1000320306201511078440737890",
  "verify_department": "UNIONPAY",
  "verify_department_trade_id": "2018112288340107038204310100000",
  "offset": 0,
  "limit": 20,
  "total_count": 1,
  "data": [
    {
      "sub_order_no": "20150806125346",
      "sub_order_id": "20150806125346",
      "mch_customs_no": "1234567",
      "customs": "SHANGHAI_ZS",
      "fee_type": "CNY",
      "order_fee": 888,
      "duty": 888,
      "transport_fee": 888,
      "product_fee": 888,
      "state": "PROCESSING",
      "explanation": "支付單已存在并且為非退單狀態(tài)",
      "modify_time": "2015-09-01T10:00:00+08:00"
    }
  ]
}

錯(cuò)誤碼

錯(cuò)誤碼	描述	解決方案
INVALID_REQUEST	該訂單沒有申報(bào)	該訂單沒有申報(bào)，請(qǐng)申報(bào)后再查詢
	查詢指定記錄不存在，請(qǐng)重新選擇條件查詢	查詢記錄不存在，請(qǐng)按要求重新查詢
	海關(guān)配置未設(shè)置	報(bào)關(guān)接口需要商戶已配置過海關(guān)信息才可以訪問。請(qǐng)參照上文中的海關(guān)備案指引，進(jìn)行海關(guān)信息報(bào)備
NOAUTH	商戶未在當(dāng)前申報(bào)的海關(guān)進(jìn)行備案	商戶未在申報(bào)的海關(guān)中備案，請(qǐng)商戶完成備案后重試；
NOAUTH	未開通自助清關(guān)功能	請(qǐng)檢查當(dāng)前商戶是否已開通自助清關(guān)功能，開通路徑：微信支付商戶平臺(tái)-產(chǎn)品中心-自助清關(guān)中申請(qǐng)開通。
PARAM_ERROR	參數(shù)錯(cuò)誤	參數(shù)錯(cuò)誤，可能參數(shù)有誤或參數(shù)遺漏，請(qǐng)檢查接口參數(shù)是否按要求提交
SYSTEMERROR	系統(tǒng)錯(cuò)誤	請(qǐng)重新報(bào)關(guān)，或聯(lián)系微信支付小助手排查原因

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

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

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

報(bào)關(guān) API

報(bào)關(guān)查詢API

接口說明

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

請(qǐng)求示例：

返回參數(shù)

正常返回

異常返回

返回示例：

錯(cuò)誤碼

版本說明