最新更新时间：2020.04.03 版本说明
该接口用于商户修改订单附加信息。
修改接口会重新生成一条新的待申报申报数据，同时作废旧的申请数据，不用再主动调用重推接口。修改接口只能对商户海关备案号、关税、子订单金额、物流费用和商品费用做修改。如修改商户海关备案号，将读取商户新的备案号和备案名称，进行重新申报。
适用对象：直连模式
接口URL：https://apihk.mch.weixin.qq.com/global/v3/customs /orders
请求方式：PATch
| 参数名 | 变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 机构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
}| 参数名 | 变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 机构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时返回，详细说明见下文 |
{
"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 | 系统错误 | 请重新报关，或联系微信支付小助手排查原因 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证