報關重推API
最新更新時間：2022.08.04 版本說明
如果訂單附加信息已請求報送海關，但電子口岸丟單，則可以使用報關重推接口重新向海關推送（訂單附加信息的state必須為SUCCESS或者EXCEPT）。
注意： ? 重推時，需要帶上支付時的商戶訂單號out_trade_no或微信支付訂單號transaction_id。若有拆單，則需要帶上商戶子單號sub_order_no或微信子單號sub_order_id。
注意： 1. 接口說明
適用對象: 直連模式 機構模式
請求URL: https://apihk.mch.weixin.qq.com/v3/global/customs/redeclare
請求方式: POST
Path指該參數(shù)為路徑參數(shù)
Query指該參數(shù)為URL參數(shù)
Body指該參數(shù)需在請求JSON傳參
2. 請求參數(shù)
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 機構APPID | appid | string[1,32] | 是 | Body微信分配的公眾賬號ID 示例值：wxd678efh567hg6787 |
| 商戶號 | mchid | string[1,32] | 是 | Body微信支付分配的商戶號 示例值：1230000109 |
| 商戶訂單號 | out_trade_no | string[1,32] | 二選一 | Body out_trade_no, transaction_id二選一傳入 示例值：20150806125346 |
| 微信訂單號 | transaction_id | string[1,32] | Body out_trade_no, transaction_id二選一傳入 示例值：1000320306201511078440737890 |
|
| 商戶子單號 | sub_order_no | string[1,32] | 否 | Body 沒有拆單可不填，否則sub_order_no, sub_order_id二選一傳入 注意：僅適用于機構模式 示例值：20150806125346 |
| 微信子單號 | sub_order_id | string[1,32] | 否 | Body 沒有拆單可不填，否則sub_order_no, sub_order_id二選一傳入 注意：僅適用于機構模式 示例值：1000320306201511078440737891 |
| 海關編碼 | customs | string[1,32] | 是 | Body 海關編碼，具體請參考海關列表 示例值：SHANGHAI_ZS |
| 商戶海關備案號 | merchant_customs_no | string[1,32] | 是 | Body 商戶在海關登記的備案號 示例值：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"
}
3. 返回參數(shù)
正常返回
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 機構APPID | appid | string[1,32] | 是 | 微信分配的公眾賬號ID 示例值：wxd678efh567hg6787 |
| 商戶號 | mchid | string[1,32] | 是 | 微信支付分配的商戶號 示例值：1230000109 |
| 報關狀態(tài) | state | string[1,32] | 是 | 申報結果狀態(tài)碼 PROCESSING：申報中 UNDECLARED：未申報 SUBMITTED：已修改未申報 SUCCESS：申報成功 FAIL：申報失敗 EXCEPT：海關接口異常 示例值：PROCESSING |
| 商戶訂單號 | out_trade_no | string[1,32] | 是 | 商戶系統(tǒng)內部訂單號，要求32個字符內，只能是數(shù)字、大小寫字母_-|*@ ，且在同一個商戶號下唯一 示例值：20150806125346 |
| 微信訂單號 | transaction_id | string[1,32] | 是 | 微信支付返回的訂單號 示例值：1000320306201511078440737890 |
| 商戶子訂單號 | sub_order_no | string[1,32] | 否 | 商戶子訂單號，如有拆單則必傳 注意：僅適用于機構模式 示例值：20150806125346 |
| 微信子訂單號 | sub_order_id | string[1,32] | 否 | 微信子訂單號 注意：僅適用于機構模式 示例值：20150806125346 |
| 最后更新時間 | modify_time | string[1,32] | 是 | 最后更新時間，該時間取自微信服務器 示例值：2015-09-01T10:00:00+08:00 |
| 申報結果說明 | explanation | string[1,128] | 否 | 申報結果說明，如果狀態(tài)是失敗或異常，顯示失敗原因 示例值：支付單已存在并且為非退單狀態(tài) |
異常返回
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | code | string[1, 32] | 是 | 錯誤碼，枚舉值見錯誤碼列表 示例值：INVALID_REQUEST |
| 返回信息 | message | string[1, 256] | 是 | 返回信息，如非空，為錯誤原因 示例值：參數(shù)格式校驗錯誤 |
| 詳細的錯誤描述 | detail | object | 否 | 當code為PARAM_ERROR時返回，詳細說明見下 |
返回示例
{
"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)"
}
4. 錯誤碼
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| INVALID_REQUEST | 海關申報記錄不存在 | 海關申報記錄不存在，請重新申請或聯(lián)系微信支付小助手排查原因 |
| 海關配置未設置 | 報關接口需要商戶已配置過海關信息才可以訪問。請參照上文中的海關備案指引，進行海關信息報備 | |
| NOAUTH | 商戶未在當前申報的海關進行備案 | 商戶未在申報的海關中備案，請商戶完成備案后重試； |
| 未開通自助清關功能 | 請檢查當前商戶是否已開通自助清關功能，開通路徑：微信支付商戶平臺-產品中心-自助清關中申請開通。 | |
| PARAM_ERROR | 參數(shù)錯誤 | 參數(shù)錯誤，可能參數(shù)有誤或參數(shù)遺漏，請檢查接口參數(shù)是否按要求提交 |
| SYSTEMERROR | 系統(tǒng)錯誤 | 請重新報關，或聯(lián)系微信支付小助手排查原因 |
頁面導航
