订单附加信息提交接口

签名

sign

是

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名，详见签名生成算法

公众账号ID

appid

是

String(32)

wxd678efh567hg6787

微信分配的公众账号ID

商户号

mch_id

是

String(32)

1230000109

微信支付分配的商户号

商户订单号

out_trade_no

是

String(32)

20150806125346

商户系统内部订单号，要求32个字符内，只能是数字、大小写字母_-|*@ ，且在同一个商户号下唯一。

微信支付订单号

transaction_id

是

String(28)

1000320306201511078440737890

微信支付返回的订单号

海关

customs

是

String(32)

SHANGHAI

商户海关备案号

mch_customs_no

是

String(32)

123456

商户在海关登记的备案号，customs非NO，此参数必填

关税

duty

否

int

888

关税，以分为单位，非必填项，不会提交给海关

报关类型

action_type

否

String

ADD

不传，默认是新增

ADD 新增报关申请

MODIFY 修改

报关信息

商户子订单号

sub_order_no

否

String(32)

20150806125346

商户子订单号，如有拆单则必传

币种

fee_type

否

String(3)

CNY

微信支付订单支付时使用的币种，暂只支持人民币CNY,如有拆单则必传。

应付金额

order_fee

否

int

888

子订单金额，以分为单位，不能超过原订单金额，order_fee=transport_fee+product_fee（应付金额=物流费+商品价格），如有拆单则必传。

物流费

transport_fee

否

int

888

物流费用，以分为单位，如有拆单则必传。

商品价格

product_fee

否

int

888

商品费用，以分为单位，如有拆单则必传。

证件类型

cert_type

否

String(32)

IDCARD

请传固定值IDCARD,暂只支持大陆身份证。

证件号码

cert_id

否

String(64)

330821198809085211

用户大陆身份证号，尾号为字母X的身份证号，请大写字母X。

姓名

name

否

String(64)

张三

用户姓名。

返回状态码

return_code

是

String(16)

SUCCESS

SUCCESS/FAIL

此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断

返回信息

return_msg

否

String(128)

签名失败

返回信息，如非空，为错误原因

如：签名失败 等。

签名类型

sign_type

是

String(32)

MD5

暂只支持MD5

签名

sign

是

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名，详见签名生成算法

公众账号ID

appid

是

String(32)

wxd678efh567hg6787

微信分配的公众账号ID

商户号

mch_id

是

String(32)

1230000109

微信支付分配的商户号

业务结果

result_code

是

String(16)

SUCCESS

SUCCESS/FAIL

错误代码

err_code

否

String(32)

SYSTEMERROR

详细参见错误列表

错误代码描述

err_code_des

否

String(128)

系统错误

错误返回的信息描述

状态码

state

是

String(32)

UNDECLARED

状态码

UNDECLARED -- 未申报

SUBMITTED -- 申报已提交（订单已经送海关，商户重新申报，并且海关还有修改接口，那么记录的状态会是这个）

PROCESSING -- 申报中

SUCCESS -- 申报成功

FAIL-- 申报失败

EXCEPT --海关接口异常

微信支付订单号

transaction_id

是

String(28)

1000320306201511078440737890

微信支付返回的订单号

商户订单号

out_trade_no

是

String(32)

20150806125346

商户系统内部订单号，要求32个字符内，只能是数字、大小写字母_-|*@ ，且在同一个商户号下唯一。

商户子订单号

sub_order_no

否

String(32)

20150806125346

商户子订单号，如有拆单则必传

微信子订单号

sub_order_id

否

String(32)

20150806125346

微信子订单号

最后更新时间

modify_time

是

String(14)

20091227091010

最后更新时间，格式为yyyyMMddhhmmss，如2009年12月27日9点10分10秒表示为20091227091010。时区为GMT+8 beijing。该时间取自微信服务器

订购人和支付人身份信息校验结果

cert_check_result

是

String(256)

UNCHECKED

UNCHECKED 商户未上传订购人身份信息

SAME 商户上传的订购人身份信息与支付人身份信息一致

DIFFERENT 商户上传的订购人身份信息与支付人身份信息不一致

验核机构

verify_department

是

String(16)

UNIONPAY

验核机构包括：
银联-UNIONPAY
网联-NETSUNION
其他-OTHERS(如余额支付，零钱通支付等)

注：商户需将该字段取值UNIONPAY, NETSUNION, OTHERS映射至海关verDept字段的1、2、3

验核机构交易流水号

verify_department_trade_id

是

String(64)

2018112288340107038204310100000

交易流水号，来自验核机构，如银联记录的交易流水号，供商户报备海关

132011004

参数错误

报关时仅传入订单号，不传入子订单号（sub_order_no）时，不能填费用信息，须以支付系统中的值为准

请检查参数是否都正确

132021028

交易币种与商户结算币种不一致

报关时传入子订单号（sub_order_no）时，币种参数（fee_type）必填

请检查所传币种参数（fee_type）是否为空

MCHID_NOT_SET

商户号未设置

商户号为必传参数，请求时必传

请检查商户号是否为空

MCHID_INVALID_LENGTH

无效的商户号长度

报关接口传入的商户号长度错误

请传入正确的商户号

CUSTOMSCONFIG_NOT_SET

海关配置未设置

报关接口需要商户已配置过海关信息才可以访问

请参照上文中的海关备案指引，进行海关信息报备

FEETYPE_NOT_SET

币种类型未设置

拆单情况下，币种为必填参数

请检查fee_type是否为空

OUTTRADENO_NOT_SET

商户订单号(out_trade_no)未设置

商户订单号为必传参数

请检查商户订单号（out_trade_no）是否为空

TRANSACTION_ID_NOT_SET

微信订单号(transaction_id)未设置

微信订单号(transaction_id)为必传参数

请检查微信订单号(transaction_id)是否为空

INVALID_TRANSACTION_ID

无效的微信订单号长度

微信订单号为28位数字，请确保长度一致

请检查微信订单号(transaction_id)是否正确

CUSTOMS_NOT_SET

海关信息未设置

海关信息为必传字段

请检查海关信息是否为空

CHCUSTOMSNO_NOT_SET

海关备案号未设置

海关备案号为必传字段

请检查备案号是否为空

INVALID_MCHCUSTOMSNO

无效的海关备案号长度

海关备案号一般为6位字符串

请检查海关备案号是否正确

PAYFEE_NOT_MATCH

金额不匹配

报关的订单金额必须和支付的金额一致

请检查报关订单的金额是否正确

INVALID_SUBORDER_NO

无效的子订单号长度(sub_order_no)

子订单号要求是32位以内的字符串

请检查子订单号长度是否正确

APPID_NOT_EXIST

AppId未设置(sub_order_no)

appid为必传字段

请检查appid是否正确

MCHID_NOT_EXIST

商户号(mch_id)未设置

MCH_ID为必传字段

请检查mch_id是否正确

AUTHORITY_NOT_FOUND

未开通自助清关功能

须先开通自助清关功能才可成功调用接口

请检查是否已开通自助清关功能，开通路径：微信支付商户平台-产品中心-自助清关中申请开通。

NO_AUTH

无权限

未获得此接口的调用权限

请检查当前商户号是否已获得此接口的调用权限