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

返回上一層報關(guān) / 報關(guān)重推API

報關(guān)重推API

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

如果訂單附加信息已請求報送海關(guān)，但電子口岸丟單，則可以使用報關(guān)重推接口重新向海關(guān)推送（訂單附加信息的state必須為SUCCESS或者EXCEPT）。

注意：

重推時，需要帶上支付時的商戶訂單號out_trade_no或微信支付訂單號transaction_id。若有拆單，則需要帶上商戶子單號sub_order_no或微信子單號sub_order_id。

接口說明

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

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

請求方式：POST

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

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

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

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

請求參數(shù)

參數(shù)名	變量	類型	必填	描述
機構(gòu)APPID	appid	string(32)	是	body微信分配的公眾賬號ID 示例值：wxd678efh567hg6787
商戶號	mchid	string(32)	是	body微信支付分配的商戶號示例值：1230000109
商戶訂單號	out_trade_no	string(32)	二選一	body out_trade_no, transaction_id二選一傳入示例值：20150806125346
微信訂單號	transaction_id	string(32)	二選一	body out_trade_no, transaction_id二選一傳入示例值：1000320306201511078440737890
商戶子單號	sub_order_no	string(32)	否	body 沒有拆單可不填，否則sub_order_no, sub_order_id二選一傳入注意：僅適用于機構(gòu)模式示例值：20150806125346
微信子單號	sub_order_id	string(32)	否	body 沒有拆單可不填，否則sub_order_no, sub_order_id二選一傳入注意：僅適用于機構(gòu)模式示例值：1000320306201511078440737891
海關(guān)編碼	customs	string(32)	是	body 海關(guān)編碼，具體請參考章節(jié)3.5.10 示例值：SHANGHAI_ZS
商戶海關(guān)備案號	merchant_customs_no	string(32)	是	body 商戶在海關(guān)登記的備案號示例值：123456

請求示例：

JSON

{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "out_trade_no": "20150806125346",
  "transaction_id": "1000320306201511078440737890",
  "sub_order_no": "20150806125346",
  "sub_order_id": "1000320306201511078440737891",
  "customs": "SHANGHAI_ZS",
  "merchant_customs_no": "123456"
}

    
｛
JAVA示例代碼
｝

返回參數(shù)

正常返回

參數(shù)名	變量	類型	必填	描述
機構(gòu)APPID	appid	string(32)	是	微信分配的公眾賬號ID 示例值：wxd678efh567hg6787
商戶號	mchid	string(32)	是	微信支付分配的商戶號示例值：1230000109
報關(guān)狀態(tài)	state	string(32)	是	申報結(jié)果狀態(tài)碼 PROCESSING：申報中 UNDECLARED：未申報 SUBMITTED：已修改未申報 SUCCESS：申報成功 FAIL：申報失敗 EXCEPT：海關(guān)接口異常示例值：PROCESSING
商戶訂單號	out_trade_no	string(32)	是	商戶系統(tǒng)內(nèi)部訂單號，要求32個字符內(nèi)，只能是數(shù)字、大小寫字母_-\|*@ ，且在同一個商戶號下唯一示例值：20150806125346
微信訂單號	transaction_id	string(32)	是	微信支付返回的訂單號示例值：1000320306201511078440737890
商戶子訂單號	sub_order_no	string(32)	否	商戶子訂單號，如有拆單則必傳注意：僅適用于機構(gòu)模式示例值：20150806125346
微信子訂單號	sub_order_id	string(32)	否	微信子訂單號注意：僅適用于機構(gòu)模式示例值：20150806125346
最后更新時間	modify_time	string(32)	是	最后更新時間，該時間取自微信服務(wù)器示例值：2015-09-01T10:00:00+08:00
申報結(jié)果說明	explanation	string(128)	否	申報結(jié)果說明，如果狀態(tài)是失敗或異常，顯示失敗原因示例值：支付單已存在并且為非退單狀態(tài)

異常返回

參數(shù)名

變量

類型

必填

描述

返回狀態(tài)碼

code

string（32）

是

錯誤碼，枚舉值見錯誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string（256）

是

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

+詳細錯誤描述

detail

object

否

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

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

返回示例：

正常示例

{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "state": "PROCESSING",
  "out_trade_no": "20150806125346",
  "transaction_id": "1000320306201511078440737890",
  "sub_order_no": "20150806125346",
  "sub_order_id": "20150806125346",
  "modify_time": "2015-09-01T10:00:00+08:00",
  "explanation": "支付單已存在并且為非退單狀態(tài)"
}

錯誤碼

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

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

報關(guān) API

報關(guān)重推API

注意：

接口說明

請求參數(shù)

請求示例：

返回參數(shù)

正常返回

異常返回

返回示例：

錯誤碼

版本說明