通联支付网络服务股份有限公司 海关商户扩展字段补充说 明 版本 v1.0 通联支付网络服务股份有限公司 2015 年 4 月 8 日
文件修改记录 修改说明 版本 变更审核批准 时间变更人时间审核人时间批准人 新建 1.0 2015.04.08 郝捍东 新增郑州海关 1.1 2015.04.29 郝捍东
目录 1. 目的... 4 2. 说明... 4 3. 商户系统接入扩展字段定义... 4 3.1 重庆海关... 4 3.2 郑州海关... 4 3.3 济南海关... 5 4. ext2 值计算... 8
1. 目的 2. 说明 本文档作为 通联互联网支付网关商户接口技术规范.docx 的补充文档使用 本文档为使用通联互联网支付网关的海关类商户开发者编写 本文档为通联互联网支付网关的开发者和相关人员提供有效的指引和帮助 本文档的目标读者为技术人员 接海关报关商户除需要上送 通联互联网支付网关商户接口技术规范.docx 中的 3.1 接口的基本订单字段外, 需加送 3 中的字段 并且需对加送的字段的值计算 MD5 摘要, 摘要值填入 通联互联网支付网关商户接口技术规范.docx 中的 3.1 的 ext2 中上送 3. 商户系统接入扩展字段定义 3.1 重庆海关 <GW_CUSTOMS><CUSTOMS_TYPE>HG001</CUSTOMS_TYPE ><BIZ_TYPE_CODE>1</BIZ_TYPE_CODE><ESHOP_ENT_C ODE>23456</ESHOP_ENT_CODE><ESHOP_ENT_NAME>ABC </ESHOP_ENT_NAME><GOODS_FEE>190</GOODS_FEE><T AX_FEE>5</TAX_FEE><FREIGHT_FEE>5</FREIGHT_FEE ><OTHER_FEE>0</OTHER_FEE></GW_CUSTOMS> HG001) BIZ_TYPE_CODE: 业务类型 ( 直购进口 :I10, 网购保税进口 :I20) ESHOP_ENT_CODE: 电商企业代码 (10 位海关代码 ) ESHOP_ENT_NAME: 电商企业名称 ( 企业备案的企业全称 ) GOODS_FEE: 商品货款金额 TAX_FEE: 税款金额 FREIGHT_FEE: 运费 OTHER_FEE 其他费用备注 : 以上参数全为必输项, 货款金额 税款金额和运费之和等于商户订单金额 3.2 郑州海关 <GW_CUSTOMS><CUSTOMS_TYPE>HG002</CUSTOMS_TYPE>
<ESHOP_ENT_CODE>23456</ESHOP_ENT_CODE><ESHOP_E NT_NAME>ABC</ESHOP_ENT_NAME><IETYPE>E</IETYPE> <MEMO></MEMO></GW_CUSTOMS> HG002) 必填项固定值 HG002 ESHOP_ENT_CODE: 电商平台的海关备案代码必填项 varchar(40) ESHOP_ENT_NAME: 电商平台的海关备案名称必填项 varchar(100) IETYPE: 进出口标志 I: 进口 E: 出口必填项 varchar(1) MEMO: 备注可不填 varchar(100) 备注 : 非必输项标签不可空, 必须是全标签格式, 不支持 <a/> 的形式, 为紧凑格式字符串, 不能使用不必要的空格和回车等字符 3.3 济南海关 <GW_CUSTOMS><CUSTOMS_TYPE>HG003</CUSTOMS_TYPE> <ESHOP_ENT_CODE>23456</ESHOP_ENT_CODE><ESHOP_E NT_NAME>ABC</ESHOP_ENT_NAME><APP_UID></APP_UID ><APP_UNAME></APP_UNAME><MEMO></MEMO></GW_CUST OMS> HG003) 必填项固定值 HG003 ESHOP_ENT_CODE: 电商平台的海关备案代码必填项 varchar(40) ESHOP_ENT_NAME: 电商平台的海关备案名称必填项 varchar(100) APP_UID: 用户编号 ( 电子口岸持卡人 IC 卡或 IKEY 编号 ) 可不填 varchar(20) APP_UNAME: 用户名称 ( 电子口岸持卡人姓名 ) 可不填 varchar(60) MEMO: 备注可不填 varchar(100) 备注 : 非必输项标签不可空, 必须是全标签格式, 不支持 <a/> 的形式, 为紧凑格式字符串, 不能使用不必要的空格和回车等字符 3.4 西安海关 <GW_CUSTOMS><CUSTOMS_TYPE>HG005</CUSTOMS_TYPE>
<ESHOP_ENT_CODE>23456</ESHOP_ENT_CODE><ESHOP_E NT_NAME>ABC</ESHOP_ENT_NAME><APP_UID></APP_UID ><APP_UNAME></APP_UNAME><MEMO></MEMO></GW_CUST OMS> HG003) 必填项固定值 HG005 ESHOP_ENT_CODE: 电商平台的海关备案代码必填项 varchar(40) ESHOP_ENT_NAME: 电商平台的海关备案名称必填项 varchar(100) APP_UID: 用户编号 ( 电子口岸持卡人 IC 卡或 IKEY 编号 ) 必填项 varchar(20) APP_UNAME: 用户名称 ( 电子口岸持卡人姓名 ) 必填项 varchar(60) MEMO: 备注可不填 varchar(100) 备注 : 非必输项标签不可空, 必须是全标签格式, 不支持 <a/> 的形式, 为紧凑格式字符串, 不能使用不必要的空格和回车等字符 3.5 福建海关 <GW_CUSTOMS><CUSTOMS_TYPE>HG006</CUSTOMS_TYPE> <ESHOP_ENT_CODE>23456</ESHOP_ENT_CODE><ESHOP_E NT_NAME>ABC</ESHOP_ENT_NAME><APP_UID></APP_UID ><APP_UNAME></APP_UNAME><MEMO></MEMO></GW_CUST OMS> HG003) 必填项固定值 HG006 ESHOP_ENT_CODE: 电商平台的海关备案代码必填项 varchar(40) ESHOP_ENT_NAME: 电商平台的海关备案名称必填项 varchar(100) APP_UID: 用户编号 ( 电子口岸持卡人 IC 卡或 IKEY 编号 ) 可不填 varchar(20) APP_UNAME: 用户名称 ( 电子口岸持卡人姓名 ) 可不填 varchar(60) MEMO: 备注可不填 varchar(100) 备注 : 非必输项标签不可空, 必须是全标签格式, 不支持 <a/> 的形式, 为紧凑格式字符串, 不能使用不必要的空格和回车等字符
3.6 潍坊海关 <GW_CUSTOMS><CUSTOMS_TYPE>HG007</CUSTOMS_TYPE ><BIZ_TYPE_CODE>1</BIZ_TYPE_CODE><ESHOP_ENT_C ODE>23456</ESHOP_ENT_CODE><ESHOP_ENT_NAME>ABC </ESHOP_ENT_NAME><GOODS_FEE>190</GOODS_FEE><T AX_FEE>5</TAX_FEE><FREIGHT_FEE>5</FREIGHT_FEE ><OTHER_FEE>0</OTHER_FEE></GW_CUSTOMS> HG007) BIZ_TYPE_CODE: 业务类型 ( 直购进口 :I10, 网购保税进口 :I20) ESHOP_ENT_CODE: 电商企业代码 ESHOP_ENT_NAME: 电商企业名称 ( 企业备案的企业全称 ) GOODS_FEE: 商品货款金额 TAX_FEE: 税款金额 FREIGHT_FEE: 运费 OTHER_FEE 其他费用备注 : 以上参数全为必输项, 货款金额 税款金额 运费和其他费用之和等于商户订单金额 3.7 杭州海关 <GW_CUSTOMS><CUSTOMS_TYPE>HG008</CUSTOMS_TYPE ><ESHOP_ENT_CODE>23456</ESHOP_ENT_CODE><ESHOP _ENT_NAME>ABC</ESHOP_ENT_NAME><GOODS_FEE>190< /GOODS_FEE><TAX_FEE>5</TAX_FEE><FREIGHT_FEE>5 </FREIGHT_FEE><MEMO></MEMO></GW_CUSTOMS> HG008) ESHOP_ENT_CODE: 电商企业代码 ESHOP_ENT_NAME: 电商企业名称 ( 企业备案的企业全称 ) GOODS_FEE: 商品货款金额 TAX_FEE: 税款金额 FREIGHT_FEE: 运费 MEMO 备注备注 : 以上参数全为必输项, 货款金额 税款金额 运费之和等于商户订单金额
3.8 青岛海关 商 户必填 <GW_CUSTOMS><CUSTOMS_TYPE></CUSTOMS_TYPE><EC P_CODE></ECP_CODE><ECP_NAME></ECP_NAME><NOTE ></NOTE></GW_CUSTOMS> HG009) ECP_CODE: 电商企业代码 --- 长度 10 ECP_NAME: 电商企业名称 ( 企业备案的企业全称 ) --- 长度 100 NOTE: 备注 --- 长度 512 备注 : 除了 NOTE 之外, 其余三个为必输项, 非必输项标签不可空, 必须是全标签格式, 不支持 <a/> 的形式, 为紧凑格式字符串, 不能使用不必要的空格和回车等字符 4. ext2 值计算 签名原串 ext2src = customsext ext2value = MD5Encode(ext2esrc) MD5Encode() 方法参见 通联互联网支付网关商户接口技术规范.docx 中的 4. 签名及验签机制 eg: ext2src=<gw_customs><customs_type>hg001</customs_type><biz_type_code>i20</bi Z_TYPE_CODE><ESHOP_ENT_CODE>2345678901</ESHOP_ENT_CODE><ESHOP_ENT_NAME>A BC</ESHOP_ENT_NAME><GOODS_FEE>190</GOODS_FEE><TAX_FEE>10</TAX_FEE></GW_CU STOMS> ext2value = 4B0FD304C5A174689822D347EF3CEA67