最新更新時(shí)間：2020.04.03 版本說明
如果訂單附加信息已請(qǐng)求報(bào)送海關(guān)，但電子口岸丟單，則可以使用報(bào)關(guān)重推接口重新向海關(guān)推送（訂單附加信息的state必須為SUCCESS或者EXCEPT）。
重推時(shí)，需要帶上支付時(shí)的商戶訂單號(hào)out_trade_no或微信支付訂單號(hào)transaction_id。若有拆單，則需要帶上商戶子單號(hào)sub_order_no或微信子單號(hào)sub_order_id。
適用對(duì)象：直連模式
接口URL：https://apihk.mch.weixin.qq.com/global/v3/customs /redeclare
請(qǐng)求方式：POST
接口規(guī)則：https://wechatpay-api.gitbook.io/wechatpay-api-v3/
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 機(jī)構(gòu)APPID | appid | string(32) | 是 | 微信分配的公眾賬號(hào)ID 示例值：wxd678efh567hg6787 |
| 商戶號(hào) | mchid | string(32) | 是 | 微信支付分配的商戶號(hào) 示例值：1230000109 |
| 商戶訂單號(hào) | out_trade_no | string(32) | 二選一 | out_trade_no, transaction_id二選一傳入 示例值：20150806125346 |
| 微信訂單號(hào) | transaction_id | string(32) | out_trade_no, transaction_id二選一傳入 示例值：1000320306201511078440737890 |
|
| 商戶子單號(hào) | sub_order_no | string(32) | 否 | 沒有拆單可不填，否則sub_order_no, sub_order_id二選一傳入 示例值：20150806125346 |
| 微信子單號(hào) | sub_order_id | string(32) | 否 | 沒有拆單可不填，否則sub_order_no, sub_order_id二選一傳入 示例值：1000320306201511078440737891 |
| 海關(guān)編碼 | customs | string(32) | 是 | 海關(guān)編碼，具體請(qǐng)參考章節(jié)3.5.10 示例值：SHANGHAI_ZS |
| 商戶海關(guān)備案號(hào) | merchant_customs_no | string(32) | 是 | 商戶在海關(guān)登記的備案號(hào) 示例值：123456 |
{
"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"
}| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 機(jī)構(gòu)APPID | appid | string(32) | 是 | 微信分配的公眾賬號(hào)ID 示例值：wxd678efh567hg6787 |
| 商戶號(hào) | mchid | string(32) | 是 | 微信支付分配的商戶號(hào) 示例值：1230000109 |
| 報(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 |
| 商戶訂單號(hào) | out_trade_no | string(32) | 是 | 商戶系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫字母_-|*@ ，且在同一個(gè)商戶號(hào)下唯一 示例值：20150806125346 |
| 微信訂單號(hào) | transaction_id | string(32) | 是 | 微信支付返回的訂單號(hào) 示例值：1000320306201511078440737890 |
| 商戶子訂單號(hào) | sub_order_no | string(32) | 否 | 商戶子訂單號(hào)，如有拆單則必傳 示例值：20150806125346 |
| 微信子訂單號(hào) | sub_order_id | string(32) | 否 | 微信子訂單號(hào) 示例值：20150806125346 |
| 最后更新時(shí)間 | modify_time | string(32) | 是 | 最后更新時(shí)間，該時(shí)間取自微信服務(wù)器 示例值：2015-09-01T10:00:00+08:00 |
| 申報(bào)結(jié)果說明 | explanation | string(128) | 否 | 申報(bào)結(jié)果說明，如果狀態(tài)是失敗或異常，顯示失敗原因 示例值：支付單已存在并且為非退單狀態(tài) |
| 參數(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ì)說明見下文 |
{
"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)"
}| 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|
| INVALID_REQUEST | 海關(guān)申報(bào)記錄不存在 | 海關(guān)申報(bào)記錄不存在，請(qǐng)重新申請(qǐng)或聯(lián)系微信支付小助手排查原因 |
| 海關(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)商戶完成備案后重試； |
| 未開通自助清關(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)系微信支付小助手排查原因 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證