Latest update time：2020.06.02 Release notes
If additional order information has been submitted to the customs but is lost in the electronic port, the customs declaration re-push API can be used to push the information to the customs again (the additional order information must be in the SUCCESS or EXCEPT state). For re-push, out_trade_no (merchant order No. upon payment) or transaction_id (WeChat Pay order No.) must be included. For a split order, sub_order_no (merchant sub-order No.) or sub_order_id (WeChat sub-order No.) must be included.
Request Url: https://apihk.mch.weixin.qq.com/global/v3/customs/redeclare
Request method:POST
API rules：https://wechatpay-api.gitbook.io/wechatpay-api-v3/
Applicable object:Common mode
path parameter is a path parameter.
query parameter needs to be passed in the request URL.
body parameter needs to be passed in the request JSON.
| Name | Variable Name | Type | Required | Description |
|---|---|---|---|---|
| Institution APPID | appid | String(32) | Yes | body Specifies Official Account ID assigned by WeChat Example：wxd678efh567hg6787 |
| Merchant ID | mchid | String(32) | Yes | body Specifies Merchant ID assigned by WeChat Payment Example：1230000109 |
| Merchant order No. | out_trade_no | String(32) | Yes | body internal order No. of the merchant system. Should be within 32 characters and can only contain numbers, uppercase and lowercase letters, and _-|*@. It is unique for a merchant ID. Example：20150806125346 |
| WeChat order No. | transaction_id | String(32) | Yes | body Order No. returned by WeChat Pay Example：1000320306201511078440737890 |
| Customs | customs | String(32) | Yes | body Customs for declaration. For the enumerated values, refer to Parameter Specifications Example：SHANGHAI_ZS |
| Merchant's customs registration No. | merchant_customs_no | String(32) | Yes | body Customs registration No. of the merchant Example：123456 |
| Merchant sub-order No. | sub_order_no | String(32) | No | body Merchant sub-order No. It is required if there is a split order. Example：20150806125346 |
| WeChat sub-order No. | sub_order_id | String(32) | No | body For a non-split order, this field can be left blank. Otherwise, pass either sub_order_no or sub_order_id. Example：1000320306201511078440737891 |
{
"appid": "wxd678efh567hg6787",
"mchid": "1230000109",
"out_trade_no": "20150806125346",
"transaction_id": "1000320306201511078440737890",
"sub_order_no": "20150806125346",
"sub_order_id": "1000320306201511078440737891",
"customs": "SHANGHAI_ZS",
"customs": "SHANGHAI_ZS",
"merchant_customs_no": "123456"
}
| Name | Variable Name | Type | Required | Description |
|---|---|---|---|---|
| Institution APPID | appid | string(32) | Yes | Official Account ID assigned by WeChat Example：wxd678efh567hg6787 |
| Merchant ID | mchid | string(32) | Yes | Merchant ID assigned by WeChat Pay Example：1230000109 |
| Declaration status | state | string(32) | Yes | Declaration result status code PROCESSING：Declaration in process UNDECLARED：Undeclared SUBMITTED：Modified but not declared SUCCESS：Declaration succeeded FAIL：Declaration failed EXCEPT：Exceptional customs API Example：PROCESSING |
| Merchant order No. | out_trade_no | string(32) | Yes | internal order No. of the merchant system. Should be within 32 characters and can only contain numbers, uppercase and lowercase letters, and _-|*@. It is unique for a merchant ID. Example：20150806125346 |
| WeChat order No. | transaction_id | string(32) | Yes | Order No. returned by WeChat Pay Example：1000320306201511078440737890 |
| Merchant sub-order No. | sub_order_no | String(32) | No | Merchant sub-order No. It is required if there is a split order. Example：20150806125346 |
| WeChat sub-order No. | sub_order_id | String(32) | No | WeChat sub-order No. Example：1000320306201511078440737891 |
| Last update time | modify_time | string(32) | Yes | Last update time, which is obtained from the WeChat server. Example：2015-09-01T10:00:00+08:00 |
| Description of declaration results | explanation | string(32) | No | Description of declaration results. The failure reason will be displayed in case of failure or exception. Example：The payment order already exists and is in a non-refund status.0 |
| Name | Variable Name | Type | Required | Description |
|---|---|---|---|---|
| Return Status Code |
return_code | String(32) | Yes | Error code. See the error code list for the enumerated values. Example：INVALID_REQUEST |
| Returned message | message | String(256) | Yes | Returned message. If not empty, it presents the cause of the error. Example：Parameter format verification error |
| +Detailed error description | detail | Object | No | It is returned when code is PARAM_ERROR. Details will be described below |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证