篇一：通联互联网支付网关商户接口技术规范(20150123)
文件修改记录
目录
1.
2. 目的................................................................................................................................................... 5 通联互联网支付网关业务简介 ....................................................................................................... 5
2.1 名词解释............................................................................................................................ 5
2.2 商户与通联合作程序 ........................................................................................................ 5
2.3 支付业务流程 .................................................................................................................... 5
2.3.1 通联互联网支付网关的网银支付流程 ................................................................... 5
2.3.2 通知支付结果处理流程 ........................................................................................... 6
2.3.3 退款流程 ................................................................................................................... 6
a) 轧差退款 ....................................................................................................................... 6
b) 收支两条线退款 ........................................................................................................... 6
商户系统接入接口定义 ................................................................................................................... 7
3.1 页面订单提交接口 ............................................................................................................ 7
3.2 支付结果返回接口 ............................................................................................................ 9
3.3 单笔订单查询接口 .......................................................................................................... 10
3.4 单笔订单查询结果返回接口 .......................................................................................... 11
3.5 批量订单查询接口 .......................................................................................................... 11
3.6 批量订单查询结果返回接口 .......................................................................................... 11
3.7 单笔订单退款申请接口 .................................................................................................. 12
3.8 单笔订单退款申请接口返回 .......................................................................................... 13
3.9退款状态查询接口 ........................................................................................................... 14
3.10退款状态查询返回 ......................................................................................................... 14
3.11商户汇率查询接口 ......................................................................................................... 17
3.12商户汇率查询结果返回接口 ......................................................................................... 18
3.13业务扩展字段extTL介绍 .............................................................................................. 19
3.13.1单笔分账业务 ............................................................................................................ 19
3.13.1.1 格式 ......................................................................................................................... 19
3.13.1.2参数说明................................................................................................................... 19
3.13.1.3分账示例................................................................................................................... 19
3.13.2单笔手续费收取业务 ................................................................................................ 20
3.13.2.1格式 .......................................................................................................................... 20
3.13.2.2 规则说明.................................................................................................................. 20
3.13.2.3 手续费示例 .............................................................................................................. 20
3.13.3 海关扩展字段要求 ................................................................................................... 20
签名及验签机制 ............................................................................................................................. 21
4.1 进行MD5加密的签名源串及顺序 ................................................................................ 21
4.2 签名 ................................................................................................................................. 21
4.3 验签 ................................................................................................................................. 22
开发................................................................................................................................................. 23
5.1 开发步骤.......................................................................................................................... 23
5.1.1 Java环境 ................................................................................................................ 23
5.1.2 ASP和dotNet环境 ................................................................................................ 23 3. 4. 5.
6. 5.1.3 PHP环境 .................................................................................................................. 23 5.2 示例代码(Java) ................................................................................................................ 24 5.2.1 商户网站对交易订单的报文组装关键代码 ......................................................... 24 5.2.2 商户网站对交易结果的签名验证关键代码 ......................................................... 26 附录................................................................................................................................................. 28
6.1系统错误码 ....................................................................................................................... 28
6.2系统异常码 ....................................................................................................................... 29
6.3证件类型........................................................................................................................... 30
6.4B2C支持银行代码 ............................................................................................................ 30
6.5B2B支持银行代码(跨境支付商户暂不支持B2B支付) .................................................. 31
6.6币种类型........................................................................................................................... 31
6.7国家和币种代码（参考资料） ...................................................................................... 32
1. 目的
本文档为使用通联互联网支付网关的商户开发者编写。
本文档为通联互联网支付网关的开发者和相关人员提供有效的指引和帮助。
本文档的目标读者为技术人员。
2. 通联互联网支付网关业务简介
2.1 名词解释
客户、持卡人：是指支付过程中的付款方，通常分为“个人客户”和“公司客户”。
商户：是指支付过程中的收款方，商户需要向我司相关部门申请后获得商户身份，完成商户开户后会分配一个商户号给该商户。
通联支付网关(Payment Gateway)：是银行金融网络系统和Internet网络之间的接口，本文档中的通联支付网关是通联处理商家支付信息和顾客的支付指令并连接各银行完成支付业务的银行前置系统。
2.2 商户与通联合作程序
1. 商户与通联签订商户接入协议，通联为商户在通联支付网关系统开户
2. 通联为该商户提供测试环境地址、商户号、KEY值及证书，同时向商户提供支付网关
的开发包与接入开发指南
3. 商户系统加载开发包，完成客户端开发并与通联支付网关测试系统进行联机测试
4. 商户测试环境联调成功后，通联向商户发放生产商户号、KEY值、正式证书
1) 通联业务人员配置商户证书基本信息，生成商户证书
2) 通联业务人员审核允许商户下载证书
3) 商户登录通联商户服务网站下载证书
5. 商户参数配置
1) 商户在通联注册的商户号
2) 交易类型
3) 通知接收地址
4) 加密方式
5) 其他支付参数
6. 通联为商户开通互联网支付网关的接入权限
7. 投入生产
8. 清算结算及差错处理
9. 报表下载
2.3 支付业务流程
2.3.1 通联互联网支付网关的网银支付流程
1. 客户在商户网站选择商品，商户网站创建一个订单支付请求，支付参数采用HTTP表单
（FORM）方式提交（订单上送格式参见3.1小节页面订单提交接口）
2. 客户点击支付按钮，将订单发送到通联互联网支付网关的支付页面，支付页面路径如下：
http(s)://通联支付网关地址/gateway/index.do
篇二：通联互联网支付网关商户接口技术规范(20140417)
文件修改记录
目录
1.
2. 目的................................................................................................................................................... 5 通联互联网支付网关业务简介 ....................................................................................................... 5
2.1 名词解释............................................................................................................................ 5
2.2 商户与通联合作程序 ........................................................................................................ 5
2.3 支付业务流程 .................................................................................................................... 5
2.3.1 通联互联网支付网关的网银支付流程 ................................................................... 5
2.3.2 通知支付结果处理流程 ........................................................................................... 6
2.3.3 清算结算流程 ........................................................................................................... 6
2.3.4 退货流程 ................................................................................................................... 6
商户系统接入接口定义 ................................................................................................................... 6
3.1 页面订单提交接口 ............................................................................................................ 6
3.2 支付结果返回接口 ............................................................................................................ 9
3.3 单笔订单查询接口 .......................................................................................................... 10
3.4 单笔订单查询结果返回接口 .......................................................................................... 10
3.5 批量订单查询接口 .......................................................................................................... 11
3.6 批量订单查询结果返回接口 .......................................................................................... 11
3.7 单笔订单退款接口 .......................................................................................................... 12
3.8 单笔订单退款结果返回接口 .......................................................................................... 12
3.9 业务扩展字段extTL介绍 ............................................................................................... 13
3.9.1单笔分账业务.............................................................................................................. 13
3.9.1.1 格式 ........................................................................................................................... 13
3.9.1.2参数说明 .................................................................................................................... 13
3.9.1.3 分账示例 ................................................................................................................... 14
3.9.2单笔手续费收取业务 .................................................................................................. 14
3.9.2.1格式 ............................................................................................................................ 14
3.9.2.2 规则说明 ................................................................................................................... 14
3.9.2.3 手续费示例 ............................................................................................................... 14
签名及验签机制 ............................................................................................................................. 15
4.1 进行MD5加密的签名源串及顺序 ................................................................................ 15
4.2 签名 ................................................................................................................................. 15
4.3 验签 ................................................................................................................................. 16
开发................................................................................................................................................. 16
5.1 开发步骤.......................................................................................................................... 16
5.1.1 Java环境 ................................................................................................................ 16
5.1.2 ASP和dotNet环境 ................................................................................................ 17
5.1.3 PHP环境 .................................................................................................................. 17
5.2 示例代码(Java) ................................................................................................................ 17
5.2.1 商户网站对交易订单的报文组装关键代码 ......................................................... 17
5.2.2 商户网站对交易结果的签名验证关键代码 ......................................................... 20
商户接入常见问题与解决Q&A .................................................................................................... 21 附录................................................................................................................................................. 22 3. 4. 5. 6. 7.
7.1系统错误码 ....................................................................................................................... 22
7.2系统异常码 ....................................................................................................................... 24
7.3证件类型........................................................................................................................... 25
7.4B2C支持银行代码 ............................................................................ 错误！未定义书签。
7.5B2B支持银行代码 ............................................................................ 错误！未定义书签。
7.6WAP支付支持银行 ........................................................................... 错误！未定义书签。
7.7外卡支付支持银行 ........................................................................................................... 25
7.8币种类型........................................................................................................................... 25
1. 目的
本文档为使用通联互联网支付网关的商户开发者编写。
本文档为通联互联网支付网关的开发者和相关人员提供有效的指引和帮助。
本文档的目标读者为技术人员。
2. 通联互联网支付网关业务简介
2.1 名词解释
客户、持卡人：是指支付过程中的付款方，通常分为“个人客户”和“公司客户”。
商户：是指支付过程中的收款方，商户需要向我司相关部门申请后获得商户身份，完成商户开户后会分配一个商户号给该商户。
通联支付网关(Payment Gateway)：是银行金融网络系统和Internet网络之间的接口，本文档中的通联支付网关是通联处理商家支付信息和顾客的支付指令并连接各银行完成支付业务的银行前置系统。
2.2 商户与通联合作程序
1. 商户与通联签订商户接入协议，通联为商户在通联支付网关系统开户
2. 通联为该商户提供测试环境地址、商户号、KEY值及证书，同时向商户提供支付网关
的开发包与接入开发指南
3. 商户系统加载开发包，完成客户端开发并与通联支付网关测试系统进行联机测试
4. 商户测试环境联调成功后，通联向商户发放生产商户号、KEY值、正式证书
1) 通联业务人员配置商户证书基本信息，生成商户证书
2) 通联业务人员审核允许商户下载证书
3) 商户登录通联商户服务网站下载证书
5. 商户参数配置
1) 商户在通联注册的商户号
2) 交易类型
3) 通知接收地址
4) 加密方式
5) 其他支付参数
6. 通联为商户开通互联网支付网关的接入权限
7. 投入生产
8. 清算结算及差错处理
9. 报表下载
2.3 支付业务流程
2.3.1 通联互联网支付网关的网银支付流程
1. 客户在商户网站选择商品，商户网站创建一个订单支付请求，支付参数采用HTTP表单
（FORM）方式提交（订单上送格式参见3.1小节页面订单提交接口）
2. 客户点击支付按钮，将订单发送到通联互联网支付网关的支付页面，支付页面路径如下：
http(s)://通联支付网关地址/gateway/index.do
免费论文网友情提示：本网站所有内容为共享上传提供，不涉及任何商业利益，本站对此不承担任何保证责任！
Copyright © www.csmayi.cn Corporation, All Rights Reserved 共享时代 共享你我他 版权所有