Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

报关重推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/

请求参数

参数名 变量 类型 必填 描述
机构APPID appid string(32) 微信分配的公众账号ID
示例值:wxd678efh567hg6787
商户号 mchid string(32) 微信支付分配的商户号
示例值:1230000109
商户订单号 out_trade_no string(32) 二选一 out_trade_no, transaction_id二选一传入
示例值:20150806125346
微信订单号 transaction_id string(32) out_trade_no, transaction_id二选一传入
示例值:1000320306201511078440737890
商户子单号 sub_order_no string(32) 没有拆单可不填,否则sub_order_no, sub_order_id二选一传入
示例值:20150806125346
微信子单号 sub_order_id string(32) 没有拆单可不填,否则sub_order_no, sub_order_id二选一传入
示例值:1000320306201511078440737891
海关编码 customs string(32) 海关编码,具体请参考章节3.5.10
示例值:SHANGHAI_ZS
商户海关备案号 merchant_customs_no string(32) 商户在海关登记的备案号
示例值: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"
}
    
{
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 海关申报记录不存在 海关申报记录不存在,请重新申请或联系微信支付小助手排查原因
海关配置未设置 报关接口需要商户已配置过海关信息才可以访问。请参照上文中的海关备案指引,进行海关信息报备
NOAUTH 商户未在当前申报的海关进行备案 商户未在申报的海关中备案,请商户完成备案后重试;
未开通自助清关功能 请检查当前商户是否已开通自助清关功能,开通路径:微信支付商户平台-产品中心-自助清关中申请开通。
PARAM_ERROR 参数错误 参数错误,可能参数有误或参数遗漏,请检查接口参数是否按要求提交
SYSTEMERROR 系统错误 请重新报关,或联系微信支付小助手排查原因

版本说明

关闭
V1.0
2020年4月3日
1. 报关重推API上线

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global