篇一：通联互联网支付网关商户接口技术规范(20141210)
文件修改记录
目录
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 批量订单查询结果返回接口 .......................................................................................... 12
3.7 单笔订单退款申请接口 .................................................................................................. 12
3.8 单笔订单退款申请接口返回 .......................................................................................... 13
3.9退款状态查询接口 ........................................................................................................... 14
3.10退款状态查询返回 ......................................................................................................... 14
3.11商户汇率查询接口 ......................................................................................................... 17
3.12商户汇率查询结果返回接口 ......................................................................................... 18
3.13业务扩展字段extTL介绍 .............................................................................................. 18
3.13.1单笔分账业务 ............................................................................................................ 18
3.13.1.1 格式 ......................................................................................................................... 19
3.13.1.2参数说明................................................................................................................... 19
3.13.1.3分账示例................................................................................................................... 19
3.13.2单笔手续费收取业务 ................................................................................................ 19
3.13.2.1格式 .......................................................................................................................... 19
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) ................................................................................................................ 23 5.2.1 商户网站对交易订单的报文组装关键代码 ......................................................... 24 5.2.2 商户网站对交易结果的签名验证关键代码 ......................................................... 26 附录................................................................................................................................................. 27
6.1系统错误码 ....................................................................................................................... 27
6.2系统异常码 ....................................................................................................................... 29
6.3证件类型........................................................................................................................... 30
6.4B2C支持银行代码 ............................................................................................................ 30
6.5B2B支持银行代码(跨境支付商户暂不支持B2B支付) .................................................. 31
6.6WAP支付支持银行(跨境支付商户暂不支持WAP支付) ............................................... 31
6.7币种类型........................................................................................................................... 32
6.8国家和币种代码（参考资料） ...................................................................................... 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
篇二：通联互联网支付网关商户接口技术规范(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
篇三：通联支付收款业务合作协议
通联支付收款业务合作协议
甲方：通联支付网络服务股份有限公司广东分公司
乙方：
丙方： 广州龙庭汇酒店管理有限公司
为进一步推动甲、乙、丙三方长期、全面、深入的合作，促进收款业务的高效、快捷、 安全，甲、乙、丙三方经友好协商，就甲方为乙方、丙方收款业务和专业化服务事宜签订本协议并承诺共同遵守。
相关说明：
1）本协议内所指银行卡限指本协议书规定的借记卡（储蓄卡）、信用卡。2）本协议适用于乙方的收款业务以刷借记卡（储蓄卡）、信用卡的方式完成收款的交易。
1、三方声明
本协议三方均知悉并完全理解本协议内容，同意按照本协议的有关条款办理POS 终端机具安装和受理银行卡业务。
2、合作期限
本协议合作期限自 年 月 日起至年 月 日。
若本协议合作期限届满一个月前，三方均未书面提出终止本协议，则本协议合作期限自动延长一年。
3、责任及义务
3.1 甲方的责任及义务：
3.1.1 甲方向乙方提供设备终端，供乙方用于收款业务，并保证业务支付环节正常运行。
3.1.2 甲方为乙方的POS 终端交易做好资金清算工作，定期向乙方提供收款业务的清算报表等数据，以此作为甲乙双方结算的依据。
3.1.3 对于乙方使用甲方设备终端开展收款业务过程中发生的关于交易、资金清算方面的疑问或投诉，甲方应配合乙方及时处理。
3.1.4 对于乙方使用甲方设备终端开展收款业务过程中交易资金安全、风险等，甲方负责进行资金安全的监管和交易风险的监控。
3.1.5 甲方应配臵专门人员负责与乙方的日常联络、沟通，并及时协助乙方解决设备收款业务中支付环节遇到的问题。
3.2 乙方的责任及义务
3.2.1 遵守银行卡相关法律、法规、规章以及银联规则，接受甲、丙两方的业务监督和检查指导。
3.2.2 提供必要的营业场所以及符合甲方设备终端的通讯接口，并按甲方规范标准进行连接。
3.2.3 当设备终端因通讯或非甲方故障导致无法完成正常的交易支付功能时，乙方应及时停止终端的所有交易，并及时解决故障并报备甲方。
3.2.4 除甲乙丙三方约定合作内容中收款业务外，乙方不得使用甲方设备终端从事其他用途，若因乙方使用甲方设备终端而引起相关投诉，造成的相应损失由乙方负责。
3.2.5 对于收款交易过程中发生的持卡人拒付等交易纠纷，由乙方负责协调、处理，甲方提供必要的协助；协调无果的，由乙方承担全部责任。
3.2.6 乙方应及时核对甲方提供的清算报表数据，如有不符，应在两个工作日内提出异议；乙方若未在两个工作日内向甲方提出异议，视同乙方认同甲方提供的交易数据。
3.2.7 乙方在POS 终端上受理银行卡交易，其所采用的交易单据须由甲方或收单行提供；
3.2.8 乙方在POS 终端上受理银行卡交易，须认真核对持卡人签名，保证其与该银行卡背面预留的名字及笔迹相符；交易单据上的任何内容均不得涂改。
3.2.9 乙方应妥善保管各类签购单据、交易数据及与交易相关的原始凭证至少2年，如因乙方对上述单据、数据及凭证保管不当或遗失而造成的经济损失由乙方承担；乙方须向定期上门维护的甲方工作人员上缴交易凭证单，上缴单据不齐全的当笔交易，甲方有权延迟乙方款项清算。
3.2.10 乙方未经甲方同意，不得向任何人透露甲方相关信息、持卡人信息和关于双方合作业务的资料。
3.2.11 乙方因电话故障或经营场所变更等原因须变更POS 接入电话的或改变装机地址的，应提前向丙方主动报告，由丙方协助乙方向甲方申请变更装机地址，在未经甲方许可的情况下，乙方不得擅自移机。
3.2.12在合作期间，如乙方或乙方工作人员出现以下违规操作包括但不限于：套现、侧录、私自移机、套用MCC、冒充本商户交易与收单机构清算、泄漏账户及交易信息、未按照规范受理银联卡、拒卡、要求持卡人支付额外手续费、涂改签购单、分单操作、以现金方式退货等，为甲方造成财产损失的，乙方应承担全部责任。
3.2.13 乙方使用甲方的设备终端，须保证设备的安全、正常使用，不得擅自打开及拆卸设备。如因乙方管理不善导致设备终端丢失或严重损坏而无法修理再用的，乙方
应负赔偿责任，甲方有权按照以下标准向乙方提出赔偿要求，并有权从乙方账款中扣除：
赔偿金额= 机价 ×（1 - 已使用月数/60）
注：有线设备赔偿金额最多不高于机价（人民币2,400元），最少不低于人民币1,000元；无线设备赔偿金额最多不高于机价（人民币3,000元），最少不低于人民币1,000元。
3.3 丙方的责任及义务
3.3.1 丙方负责按甲方的要求收集协议及各项材料，并须对乙方提交的资料真实性负责。
3.3.2 丙方有责任对乙方进行业务监督，督促商户履行受理承诺。
3.3.3 当乙方出现机具丢失、持卡人拒付、调单失败、违规操作等风险导致甲方经济损失，丙方须配合甲方展开调查，协助甲方按标准向乙方追讨赔偿。丙方须承担连带赔偿甲方全部经济损失的责任。
3.4 清算条款
3.4.1 甲方须按本协议约定的清算周期将乙方的交易扣除交易手续费后的款项清算至本协议约定的指定账户。
3.4.2 如乙方收款账户为个人账户，乙方收款人必须为法人代表。
3.4.3 在下列情况下，甲方有权采取暂缓乙方全部或部分交易资金结算、中止乙方银行卡业务受理等措施。如乙方涉及违规交易，甲方可冻结或扣划乙方款项，直至甲方认为乙方的违规交易对除乙方外的任何单位或个人无造成损失的可能。
（1）甲方提出调单时，乙方拒绝配合或不能在收到甲方调单通知起10 个工作日内提交有效交易单据；
（2）乙方的交易触发了银联、银行、甲方的风险监控系统，认定交易存在可疑之处。
3.4.4 如发生退单，甲方有权根据交易数据直接从乙方的往来款项和结算帐户中扣款，但甲方必须通知乙方。
4、违约责任
4.1 本协议生效后，各方当事人均应履行本协议约定的责任及义务，任何一方不履行或不完全履行协议约定责任及义务的，应当承担相应的违约责任。
4.2 乙方有下列情况之一的，甲方有权收回设备终端、专用单据，并有权决定是否终止本协议的履行：
（1）乙方连续3个月时间未使用甲方设备终端收款，或6个月后月交易额低于1万；
（2）由于停业、被吊销营业执照、解散、关闭、破产等原因不再继续经营；
（3）乙方的业务及交易引起客户纠纷，严重影响到甲方信誉；
（4）有违反本协议的其他行为，严重影响双方正常开展合作的。
4.3任一方若有违约情形时，守约方应书面要求其限期改正。如期限到来时仍未改正的，守约方有权自行终止本协议的执行，违约方应赔偿守约方所受之一切损害。
5、免责条款
5.1 由于国家金融政策调整、银行、中国银联内部、通联内部系统升级以及银行系统故障等原因，造成支付系统不能提供银行卡支付服务的，不视为甲方违约，甲方不承担任何责任。
5.2 由于不可抗力致使本协议不能正常履行，由三方共同协商议定处理办法。
5.3 三方在合作期间如产生对合作的不同意见甚至争议，应该本着友好、平等、互利的态度协商解决；协商不成，交由甲方所在地法院裁决。
6、保密义务
6.1 不论是在本协议有效期内，还是在本协议结束以后，未经其他方书面同意，甲、乙、丙三方均不得不正当使用本协议，以及向其他方泄露本协议履行过程中所获得的其他方的任何商业秘密、业务信息及数据（法律法规另有规定的除外），否则违约方应向守约方赔偿由此产生的所有损失。
6.2 未经各方同意，甲、乙、丙三方不得使用合作方的名称和商标等用于商业宣传和广告，如一方在合法范围内需要使用对方的名称和商标等用于商业宣传和广告，需经书面向另两方提出申请，经另两方书面授权同意后方能使用。
7、其他条款
7.1 本协议适用中华人民共和国法律、法规制度。
7.2 本协议如有未尽事宜，经甲、乙、丙三方协商一致后，可签订补充协议，用以确定本协议规定以外的约定事项，补充协议与本协议条款具有同等法律效力。
7.3 本协议一式两份，甲乙丙三方各执一份，具有同等的法律效力。
7.4 甲、乙、丙三方同意上述条款，并签订《通联支付收款业务协议签约表》，本协议从双方签字或盖章之日起生效。
8、《通联支付收款业务协议签约表》见下页。
通联支付收款业务协议签约表
注：乙丙两方签章确认时请在下行亲笔填写“我方已阅读和理解本合作协议条款”
甲方：乙方：丙方：
（公章） （公章） （公章）
日期：日期： 日期：
免费论文网友情提示：本网站所有内容为共享上传提供，不涉及任何商业利益，本站对此不承担任何保证责任！
Copyright © www.csmayi.cn Corporation, All Rights Reserved 共享时代 共享你我他 版权所有