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 版本说明


该接口用于商户修改订单附加信息。

注意:

修改接口会重新生成一条新的待申报申报数据,同时作废旧的申请数据,不用再主动调用重推接口。修改接口只能对商户海关备案号、关税、子订单金额、物流费用和商品费用做修改。如修改商户海关备案号,将读取商户新的备案号和备案名称,进行重新申报。

接口说明

适用对象:直连模式

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

请求方式:PATch

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

请求参数

参数名 变量 类型 必填 描述
机构APPID appid string(32) 微信分配的公众账号ID
示例值:wxd678efh567hg6787
商户号 mchid string(32) 微信支付分配的商户号
示例值:1230000109
商户订单号 out_trade_no string(32) 商户系统内部订单号,要求32个字符内,只能是数字、大小写字母_-|*@ ,且在同一个商户号下唯一
示例值:20150806125346
微信订单号 transaction_id string(32) 微信支付返回的订单号
示例值:1000320306201511078440737890
商户子订单号 sub_order_no string(32) 如有拆单,则必传
示例值:20150806125346
海关编码 customs string(32) 海关代码,枚举值参见参数规定-海关列表
示例值:SHANGHAI_ZS
商户海关备案号 merchant_customs_no string(32) 商户在海关登记的备案号
示例值:123456
关税 duty int 关税,以分为单位,非必填项,不会提交给海关
示例值:888
子订单金额 order_fee int 子订单金额,以分为单位,不能超过原订单金额,order\_fee=transport_fee+product_fee(应付金额=物流费+商品价格),如有拆单则必传
示例值:888
物流费用 transport_fee int 物流费用,以分为单位,如有拆单则必传
示例值:888
商品费用 product_fee int 商品费用,以分为单位,如有拆单则必传
示例值:888

请求示例:

{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "out_trade_no": "20150806125346",
  "transaction_id": "1000320306201511078440737890",
  "sub_order_no": "20150806125346",
  "customs": "SHANGHAI_ZS",
  "merchant_customs_no": "123456",
  "duty": 888,
  "order_fee": 888,
  "transport_fee": 888,
  "product_fee": 888
}
    
{
JAVA示例代码
}
    

返回参数

正常返回

参数名 变量 类型 必填 描述
机构APPID appid string(32) 微信分配的公众账号ID
示例值:wxd678efh567hg6787
商户号 mchid string(32) 微信支付分配的商户号
示例值:1230000109
报关状态 state string(32) 申报结果状态码
PROCESSING:申报中
UNDECLARED:未申报
SUBMITTED:已修改未申报
SUCCESS:申报成功
FAIL:申报失败
EXCEPT:海关接口异常
示例值:SUBMITTED
商户订单号 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
核验机构 verify_department string(16) 核验机构代码
UNIONPAY:银联
NETSUNION:网联
OTHERS:其他
示例值:UNIONPAY
核验机构流水号 verify_department_trade_id string(64) 交易流水号,来自验核机构,如银联记录的交易流水号,供商户报备海关
示例值:2018112288340107038204310100000

异常返回

参数名 变量 类型 必填 描述
返回状态码 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": "SUBMITTED",
  "out_trade_no": "20150806125346",
  "transaction_id": "1000320306201511078440737890",
  "sub_order_no": "20150806125346",
  "sub_order_id": "20150806125346",
  "modify_time": "2015-09-01T10:00:00+08:00",
  "verify_department": "UNIONPAY",
  "verify_department_trade_id": "2018112288340107038204310100000"
}

错误码

错误码 描述 解决方案
INVALID_REQUEST 海关申报记录不存在 海关申报记录不存在,请重新申请或联系微信支付小助手排查原因
支付单申报中,不能修改申报信息 当前海关不支持申报中的支付单修改信息,请等支付单完成申报后,再使用报关修改信息接口修改支付单信息
海关配置未设置 报关接口需要商户已配置过海关信息才可以访问。请参照上文中的海关备案指引,进行海关信息报备
订单金额不匹配 报关的订单金额必须和支付的金额一致,请检查报关订单的金额是否正确
NOAUTH 商户未在当前申报的海关进行备案 商户未在申报的海关中备案,请商户完成备案后重试;
未开通自助清关功能 请检查当前商户是否已开通自助清关功能,开通路径:微信支付商户平台-产品中心-自助清关中申请开通。
PARAM_ERROR 币种类型未设置 拆单情况下,币种为必填参数。请检查fee_type是否为空。
交易币种与商户结算币种不一致 请检查所传币种参数(fee_type)是否为空
参数错误 参数错误,可能参数有误或参数遗漏,请检查接口参数是否按要求提交
订单金额信息有误 订单金额与支付单金额不符,请检查后重新申报
交易单信息有误 交易单信息有误,请检查后重新申报
商户拆单申报金额不正确 商户折单金额大于原支付单金额,请检查后重新申报
交易币种与商户结算币种不一致 请重新报关,或联系微信支付小助手排查原因
拆单申报时参数缺漏 拆单时fee_type、order_fee、transport_fee和product_fee必传
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