通联互联网支付网关商户接口技术规范_商户单独报关接口规范(20170410) v2.1.docVIP

通联互联网支付网关商户接口规范 通联支付网络服务股份有限公司 商户单独报关接口说明 版本v1.1 通联支付网络服务股份有限公司 2015年07月02日 文件修改记录 修改说明 版本 变更时间 备注 新建 1.0 2015.06.19 币制编码改动 1.1 2015.07.02 新增宁波海关 1.2 2015.12.14 新增上海海关 1.3 2016.1.11 新增广州海关 1.4 2016.04.15 新增黄埔海关 1.5 2016.04.28 新增深圳报关 1.6 2016.05.31 青岛海关字段调整 新增广州单一窗口报关（海关总署版） 1.7 2016.06.23 青岛商户备案号长度改为32 新增深圳电子口岸 1.8 2016.11.22 更新郑州海关接口说明 1.9 2016.12.09 增加上海电子口岸（总署版）接口说明 2.0 2016.12.23 增加青岛电子口岸（总署版）接口说明 2.1 2016.12.26 目的 本文档为使用通联互联网支付网关的商户开发者编写。 本文档为通联互联网支付网关的开发者和相关人员提供有效的指引和帮助。 本文档的目标读者为技术人员。 通联互联网支付网关业务简介 2.1 名词解释 客户、持卡人：是指支付过程中的付款方，通常分为“个人客户”和“公司客户”。 商户：是指支付过程中的收款方，商户需要向我司相关部门申请后获得商户身份，完成商户开户后会分配一个商户号给该商户。 通联支付网关(Payment Gateway)：是银行金融网络系统和Internet网络之间的接口，本文档中的通联支付网关是通联处理商家支付信息和顾客的支付指令并连接各银行完成支付业务的银行前置系统。 2.2 商户与通联合作程序 商户与通联签订商户接入协议，通联为商户在通联支付网关系统开户 通联为该商户提供测试环境地址、商户号、KEY值及证书，同时向商户提供支付网关的开发包与接入开发指南 商户系统加载开发包，完成客户端开发并与通联支付网关测试系统进行联机测试 商户测试环境联调成功后，通联向商户发放生产商户号、KEY值、正式证书 通联业务人员配置商户证书基本信息，生成商户证书 通联业务人员审核允许商户下载证书 商户登录通联商户服务网站下载证书 商户参数配置 商户在通联注册的商户号 交易类型 通知接收地址 加密方式 其他支付参数 通联为商户开通互联网支付网关的接入权限 投入生产 清算结算及差错处理 报表下载 商户系统接入接口定义 3.1 单独报关接口 商户通过该接口进行单独报关。 接口参数如下： 测试环境： /bizweb/index.do 生产环境： /bizweb/index.do 参数名称（请求） 参数含义 长度 是否必填 参数说明 verificationText 上送字段 4096 不可空 传过来的值按照如下实例代码生成 !-- 请求报文，请使用全标签，不支持abc/格式 为紧凑格式 -- body !-- 信息域 -- txInfo !-- 商户号（15位 不能为空）-- merchantId109123456123456/merchantId !-- 版本号（固定值v5.2 不能为空）-- versionv5.2/version !-- 支付方式（固定值31 不能为空） -- payType31/payType !-- 签名类型（一般选择1 0表示订单上送和交易结果通知都使用MD5进行签名 1表示商户用使用MD5算法验签上送订单，通联交易结果通知使用证书签名） -- signType1（不能为空）/signType !-- 字符集（默认值1，UTF-8） -- charset1/charset !-- 商户单笔交易流水订单号 （不能为空，当天不能重复）-- orderNo201502121558000/orderNo !-- 商户订单生成时间（YYYYMMDDHHmmSS，不能为空） -- orderDatetime20150212155800/orderDatetime !—报关信息 -- customsInfo !—海关类别，详见5.1（不能为空） -- CUSTOMS_TYPEHG007/CUSTOMS_TYPE !— 以下参数规范请见“各海关报文规范” -- !— 电商企业代码-- ESHOP_ENT_CODE23456/ESHOP_ENT_CODE !— 电商企业名称-- ESHOP_ENT_NAMEABC/ESHOP_ENT_NAME BIZ_TYPE_CODE1/BIZ_TYPE_CODE APP_UID/APP_UID APP_UNAME/APP_UNAME TOTAL_FEE220/TOTAL_FEE GOODS_