微信支付境外文档-报关

返回上一层报关 / 报关重推API

报关重推API

最新更新时间：2020.04.03 版本说明

如果订单附加信息已请求报送海关，但电子口岸丢单，则可以使用报关重推接口重新向海关推送（订单附加信息的state必须为SUCCESS或者EXCEPT）。

注意：

重推时，需要带上支付时的商户订单号out_trade_no或微信支付订单号transaction_id。若有拆单，则需要带上商户子单号sub_order_no或微信子单号sub_order_id。

接口说明

适用对象：直连模式机构模式

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

请求方式：POST

接口规则：https://wechatpay-api.gitbook.io/wechatpay-api-v3/

path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型	必填	描述
机构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二选一传入注意：仅适用于机构模式示例值：20150806125346
微信子单号	sub_order_id	string(32)	否	body 没有拆单可不填，否则sub_order_no, sub_order_id二选一传入注意：仅适用于机构模式示例值：1000320306201511078440737891
海关编码	customs	string(32)	是	body 海关编码，具体请参考章节3.5.10 示例值：SHANGHAI_ZS
商户海关备案号	merchant_customs_no	string(32)	是	body 商户在海关登记的备案号示例值：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示例代码
｝

返回参数

正常返回

参数名	变量	类型	必填	描述
机构APPID	appid	string(32)	是	微信分配的公众账号ID 示例值：wxd678efh567hg6787
商户号	mchid	string(32)	是	微信支付分配的商户号示例值：1230000109
报关状态	state	string(32)	是	申报结果状态码 PROCESSING：申报中 UNDECLARED：未申报 SUBMITTED：已修改未申报 SUCCESS：申报成功 FAIL：申报失败 EXCEPT：海关接口异常示例值：PROCESSING
商户订单号	out_trade_no	string(32)	是	商户系统内部订单号，要求32个字符内，只能是数字、大小写字母_-\|*@ ，且在同一个商户号下唯一示例值：20150806125346
微信订单号	transaction_id	string(32)	是	微信支付返回的订单号示例值：1000320306201511078440737890
商户子订单号	sub_order_no	string(32)	否	商户子订单号，如有拆单则必传注意：仅适用于机构模式示例值：20150806125346
微信子订单号	sub_order_id	string(32)	否	微信子订单号注意：仅适用于机构模式示例值：20150806125346
最后更新时间	modify_time	string(32)	是	最后更新时间，该时间取自微信服务器示例值：2015-09-01T10:00:00+08:00
申报结果说明	explanation	string(128)	否	申报结果说明，如果状态是失败或异常，显示失败原因示例值：支付单已存在并且为非退单状态

异常返回

参数名

变量

类型

必填

描述

返回状态码

code

string（32）

是

错误码，枚举值见错误码列表
示例值：INVALID_REQUEST

返回信息

message

string（256）

是

返回信息，如非空，为错误原因
示例值：参数格式校验错误

+详细错误描述

detail

object

否

当code为PARAM_ERROR时返回，详细说明见下文

参数名	变量	类型	必填	描述
指示错误参数的字段	field	string(256)	是	当错误参数位于请求 body 的 JSON 时填写指向参数的 JSON Pointer; 当错误参数位于请求的 url 或者 querystring 时，填写参数的变量名示例值：#/properties/payer
错误参数的值	value	string(256)	是	错误参数的值示例值：1346177081915535577
具体错误原因	issue	string(256)	是	具体错误原因示例值：与 ALLOF schema 不符
错误参数的位置	location	string(256)	否	body:错误参数位于请求 body 的 JSON 中 url:错误参数位于请求 url 中 query:错误参数位于请求的 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": "支付单已存在并且为非退单状态"
}

错误码

错误码	描述	解决方案
INVALID_REQUEST	海关申报记录不存在	海关申报记录不存在，请重新申请或联系微信支付小助手排查原因
INVALID_REQUEST	海关配置未设置	报关接口需要商户已配置过海关信息才可以访问。请参照上文中的海关备案指引，进行海关信息报备
NOAUTH	商户未在当前申报的海关进行备案	商户未在申报的海关中备案，请商户完成备案后重试；
NOAUTH	未开通自助清关功能	请检查当前商户是否已开通自助清关功能，开通路径：微信支付商户平台-产品中心-自助清关中申请开通。
PARAM_ERROR	参数错误	参数错误，可能参数有误或参数遗漏，请检查接口参数是否按要求提交
SYSTEMERROR	系统错误	请重新报关，或联系微信支付小助手排查原因

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

报关 API

报关重推API

注意：

接口说明

请求参数

请求示例：

返回参数

正常返回

异常返回

返回示例：

错误码

版本说明