通联互联网支付网关商户接口技术规范

《通联互联网支付网关商户接口技术规范》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、通联互联网支付网关商户接口规范通联支付网络服务股份有限公司商户接口说明版本v4.0通联支付网络服务股份有限公司2014年12月10日通联互联网支付网关商户接口规范文件修改记录修改说明版本变更时间新建1.02012.10.16重整原有网关文档内容、增加订单批量查询接口说明1.12013.01.06修改单笔分账业务示例1.1.12013.04.03完善请求报文格式说明1.1.22013.08.19增加手机网关接入地址说明1.1.32013-11-28完善通联网关接入文档内容，新增手续费收取业务说明1.1.420

2、13-12-01调整签名方式说明更正分账业务说明增加订单唯一性说明1.1.52014-2-25调整订单过期时间说明1.162014-4-18增加人民币跨境商户直连模式要求说明1.172014-7-4退款申请接口升级1.182014-11-7增加退款查询接口1.192014-11-20支持跨境商户接入4.02014-12-10通联互联网支付网关商户接口规范目录1.目的52.通联互联网支付网关业务简介52.1名词解释52.2商户与通联合作程序52.3支付业务流程52.3.1通联互联网支付网关的网银支付流程52.

3、3.2通知支付结果处理流程62.3.3退款流程6a)轧差退款6b)收支两条线退款63.商户系统接入接口定义73.1页面订单提交接口73.2支付结果返回接口93.3单笔订单查询接口103.4单笔订单查询结果返回接口113.5批量订单查询接口113.6批量订单查询结果返回接口123.7单笔订单退款申请接口123.8单笔订单退款申请接口返回133.9退款状态查询接口143.10退款状态查询返回143.11商户汇率查询接口173.12商户汇率查询结果返回接口173.13业务扩展字段extTL介绍183.13.1单笔

4、分账业务183.13.1.1格式183.13.1.2参数说明193.13.1.3分账示例193.13.2单笔手续费收取业务193.13.2.1格式193.13.2.2规则说明193.13.2.3手续费示例203.13.3海关扩展字段要求204.签名及验签机制214.1进行MD5加密的签名源串及顺序214.2签名214.3验签225.开发225.1开发步骤225.1.1Java环境225.1.2ASP和dotNet环境23通联互联网支付网关商户接口规范5.1.3PHP环境235.2示例代码(Java)235.

5、2.1商户网站对交易订单的报文组装关键代码235.2.2商户网站对交易结果的签名验证关键代码266.附录276.1系统错误码276.2系统异常码286.3证件类型306.4B2C支持银行代码306.5B2B支持银行代码(跨境支付商户暂不支持B2B支付)316.6WAP支付支持银行(跨境支付商户暂不支持WAP支付)316.7币种类型316.8国家和币种代码（参考资料）31通联互联网支付网关商户接口规范目的本文档为使用通联互联网支付网关的商户开发者编写。本文档为通联互联网支付网关的开发者和相关人员提供有效的指引

6、和帮助。本文档的目标读者为技术人员。1.通联互联网支付网关业务简介2.1名词解释客户、持卡人：是指支付过程中的付款方，通常分为“个人客户”和“公司客户”。商户：是指支付过程中的收款方，商户需要向我司相关部门申请后获得商户身份，完成商户开户后会分配一个商户号给该商户。通联支付网关(PaymentGateway)：是银行金融网络系统和Internet网络之间的接口，本文档中的通联支付网关是通联处理商家支付信息和顾客的支付指令并连接各银行完成支付业务的银行前置系统。2.2商户与通联合作程序1.商户与通联签订商户接

7、入协议，通联为商户在通联支付网关系统开户2.通联为该商户提供测试环境地址、商户号、KEY值及证书，同时向商户提供支付网关的开发包与接入开发指南3.商户系统加载开发包，完成客户端开发并与通联支付网关测试系统进行联机测试4.商户测试环境联调成功后，通联向商户发放生产商户号、KEY值、正式证书1)通联业务人员配置商户证书基本信息，生成商户证书2)通联业务人员审核允许商户下载证书3)商户登录通联商户服务网站下载证书5.商户参数配置1)商户在通联注册的商户号2)交易类型3)通知接收地址4)加密方式5)其他支付参数6.

8、通联为商户开通互联网支付网关的接入权限7.投入生产8.清算结算及差错处理9.报表下载2.3支付业务流程2.3.1通联互联网支付网关的网银支付流程1.客户在商户网站选择商品，商户网站创建一个订单支付请求，支付参数采用HTTP表单（FORM）方式提交（订单上送格式参见3.1小节页面订单提交接口）2.客户点击支付按钮，将订单发送到通联互联网支付网关的支付页面，支付页面路径如下：http(s)://通联支付网关地址/ga