《中国银联全渠道系统商户接入测试指引(B2B产品)》由会员分享，可在线阅读，更多相关《中国银联全渠道系统商户接入测试指引(B2B产品)（61页珍藏版）》请在金锄头文库上搜索。
1、2014-11-19实施2014-11-04发布中国银联股份有限公司 发布中国银联全渠道系统商户接入测试指引-B2B产品Q/CUP 006.02014Q/CUP中国银联股份有限公司规范性文档e版本修订信息版本号完成日期发布日期变更说明1.0.02014-7-032014-7-03初稿1.0.12014-11-042014-11-05修改文档格式，新增测试地址与测试卡号等信息目录1文档说明61.1导读61.2阅读对象61.3业务术语71.4技术服务71.4.1测试模式划分71.4.2支持获取途径82联调步骤向导92.1交易开发92.2测试联调92.3切换上线93测试参数与产品相关交易93.1测试
2、与生产地址93.2测试卡号93.3产品相关交易103.4产品介绍104交易模式说明104.1通讯方式114.2前台交易流程114.3后台资金类交易流程124.4后台非资金类交易流程144.5查询交易流程145开发步骤向导155.1前台交易开发步骤155.2后台类异步交易接口开发步骤165.3后台类同步交易接口开发步骤165.4单笔查询交易接口开发步骤175.5文件传输类交易开发步骤176前台应答与后台通知说明187查询接口说明207.1前台交易207.2后台资金交易207.3后台非资金交易207.4查询交易208签名机制219加密机制2110证书相关说明2210.1概述2210.2证书下载及导
3、出流程(ok)2210.2.1证书下载流程2210.2.2证书导出流程2611开发包插件使用3111.1JSP/JAVA3111.1.1配置文件说明3111.1.2主要类和方法说明3411.1.3配置文件加载说明3711.2PHP3711.2.1配置文件说明3711.2.2主要类与方法说明4211.3ASP.NET4711.3.1配置文件说明4811.3.2主要类和方法说明5112常见问题问答561 文档说明1.1 导读B2B支付网关产品主要适用于持卡人在商户网站B2B支付场景，持卡人通过点击银联在线支付logo，并在银联在线支付网关完成支付信息录入，最终完成支付。首次接入测试先了解前台交易与
4、后台交易的区别，可参考第1.3章节业务术语描述，随后可从第5章节开发步骤向导开始阅读，了解开发过程中的具体操作步骤，此章节中提到的签名机制请参照第8章节。开发过程中需要用到的测试与生产交易地址请参考第11章节配置文件。交易测试卡号请参考第3.2章节。如开发与测试过程中遇到了解决不了的问题可在第12章节FAQ中查找解决方案，也可通过第1.4.2章节中的方法来获取测试支持。1.2 阅读对象中国银联全渠道系统商户接入测试指引文档是面向具有一定的网站开发能力的网站开发、维护和管理人员。具体交易的接口、报文规范、响应码说明，请阅读开发包中接口文档。参与方描述商户指加入银联网络，与银联签订银联卡无卡支付业
5、务合作协议等协议开展银联无卡支付以及行业类应用业务的商户。收单机构指加入银联网络，与银联签订银联卡无卡支付业务合作协议开展银联无卡支付收单业务的境内成员机构。1.3 业务术语术语解释请求通过 HTTP/HTTPS协议把需要传输的数据发送给接收方的过程。应答通过 HTTP/HTTPS协议把需要传输的数据返回给接收方的过程。后台通知服务器后台通知。中国银联全渠道系统根据得到的数据处理完成后，全渠道系统主动发起通知给商户的网站，同时携带处理完成的结果信息反馈给商户网站。前台类交易主要指用户需要参与交互的支付类交易，包括消费、预授权/担保消费交易。后台类交易主要指用户不需要参与交互，由商户后续发起的交
6、易，包括消费撤销、退货、预授权撤销、预授权完成、预授权完成撤销等交易。全渠道系统/ACP中国银联全渠道系统，是整合了银联在线和银联移动支付功能的新交易处理系统。1.4 技术服务1.4.1 测试模式划分接入B2B产品的商户为选测。注：必测是指提交了入网申请表、必须测试通过才能投产上线的，选测是指不需要入网申请表可以直接投产上线的，是否在测试环境测试由商户自己决定。必测和选测划分如下：必测选测收单机构接入商户接入（接入产品为除无跳转支付、后台直接支付、代收和便民缴费以外的其他产品）商户接入（接入产品为无跳转支付、后台直接支付、代收和便民缴费）1.4.2 支持获取途径业务问题详见开发包中中国银联全渠
7、道业务运营服务指引相关人员联系方式。测试问题支持人员联系方式详见下表：必测选测收单机构可联系银联服务专员，并且在提交了入网申请后银联服务专员会主动联系商定窗口并提供测试支持服务商户可发送邮件到邮箱（邮件标题为：商户号+商户名称+联系QQ），提供商户号和联系QQ，银联测试服务专员会将商户接口人的联系QQ加入到银联统一服务QQ中提供支持服务（商户也可以通过服务电话021-38929999-2049来提供自己的商户号和联系QQ）银联市场服务代表在为商户在提交了入网申请后，会有银联服务专员主动联系（一般为QQ）商定联调窗口并提供测试支持服务注：服务邮箱和服务电话仅供选测类商户联系测试支持人员，并且邮箱
8、和电话不直接反馈支持问题，支持服务均在银联统一服务QQ中提供。2 联调步骤向导2.1 交易开发商户参考全渠道系统开发包和本测试指引进行接入开发。2.2 测试联调开发完成后可通过银联提供的联调测试环境进行联机接口验证测试，测试地址参考第11章节配置文件说明。2.3 切换上线本步骤可选。在测试环境完成联调测试后，由银联业务运营人员(联系方式参见中国银联全渠道业务运营服务指引)引导协助商户完成生产交易证书的申请，商户将接口更新部署到生产环境和银联生产环境完成对接。3 测试参数与产品相关交易3.1 测试与生产地址测试地址详见第11章节配置文件描述。3.2 测试卡号测试卡号B2B企业网银农行虚拟卡卡号：
9、123456789001密码：7890013.3 产品相关交易序号接口名称功能说明交易模式1消费类交易持卡人进支付时，由银联或发卡行展示支付页面，引导持卡人完成后续支付的交易。前台资金类交易2退货类交易对于已结算的消费交易，通过该交易发起退款交易。后台资金类交易3交易状态查询类交易对未收到应答的或交易状态未知的交易，可通过该交易进行查询。查询类交易4文件传输类交易联机下载对账文件等文件下载类交易后台非资金交易3.4 产品介绍产品介绍详见B2B产品入网材料包中银联互联网B2B产品介绍.ppt。4 交易模式说明从技术实现方式上交易大致可划分为前台类交易、后台资金类类交易、后台非资金类交易、查询类交
10、易、批量类交易。本节将描述各种交易的大致流程。4.1 通讯方式所有报文域以key/value的表单方式通过HTTP Post到银联全渠道系统支付平台。对于前台类需要持卡人交互的交易，交易通过异步跳转的方式完成，对于涉及资金的前台类交易，银联全渠道系统支付平台可通过商户后台通知地址向商户发送后台通知。对于后台类涉及资金清算类无需持卡人交互的交易，交易结果异步响应给商户，商户通过接受后台通知或者发起交易查询获取交易处理结果。对于后台类非资金类无需持卡人交互的交易，交易结果同步响应给商户。对应交易状态查询类交易，交易结果同步响应给商户。4.2 前台交易流程前台类交易是指交易请求方（如商户、收单机构）
11、与ACP之间的交易信息通过用户浏览器进行传递的交易，是一种异步的、需要持卡人参与完成的交易类型。对于涉及金额的前台类交易（即交易请求中有金额字段）ACP系统均会给请求方后台通知(后台通知报文要素同前台应答的要素)，请求方也必须实现接收后台通知。对于交易状态未知的交易请求方必须发起交易状态查询交易。图 11注意点：1. 每个交易需要的报文要素是不一样的，具体每个交易需要的要求，请参考接口文档；2. 图 11中第8步前台应答返回的URL为请求报文中的“frontUrl”字段指定的URL；3. 图 11中第7步后台应答返回的URL为请求报文中的“backUrl”字段指定的URL；4.3 后台资金类交
12、易流程后台类资金类交易是指交易请求方（如商户、收单机构），将交易信息（涉及资金清算的交易）直接通过请求方服务器发送至ACP服务器的交易方式。是一种异步的、不需要持卡人参与完成的交易类型。因涉及资金的清算，ACP系统均会给请求方后台通知(后台通知报文要素同前台应答的要素)，请求方也必须实现接收后台通知。对于交易状态未知的交易请求方必须发起交易状态查询交易。图 13注意：1. 每个交易需要的报文要素是不一样的，具体每个交易需要的要求，请参考开发包中接口规范文档；2. 图1-3中第4步中的应答仅代表该笔后台请求交易已经受理，不代表全部处理成功；是否处理成功，需通过接受后台通知或者发起“交易状态查询交
13、易”进行查询；3. 第5步后台应答返回的URL为请求报文中的“backUrl”字段指定的URL。4.4 后台非资金类交易流程后台类非资金类交易是指交易请求方（如商户、收单机构）将交易信息（不涉及资金清算的交易）直接通过请求方服务器发送至ACP服务器的交易方式。后台非资金类交易均为同步短连接方式，不需要持卡人参与完成的交易类型。若通讯超时，则交易请求方可以重复发起交易。图 144.5 查询交易流程查询交易是指交易请求方（如商户、收单机构）将交易查询报文信息直接通过请求方服务器发送至ACP服务器的交易方式。查询类交易均为同步短连接方式，不需要持卡人参与完成的交易类型。，若通讯超时，则交易请求方可以
14、重复发起交易。图 155 开发步骤向导5.1 前台交易开发步骤1. 以表单的方式组装要发送给银联全渠道系统的数据对象（包括IC卡交易信息域，VPC交易信息域，风控信息域等各域）。每个域填写方法可参考文档开发包中接口文档。2. 将组装好的数据排序好并用&连接后签名，生成signature字段，可使用插件包提供的方法“SDKUtil.sign(未签名报文, 报文字符集);”具体签名机制请参照第8章节。可通过调用插件包提供的签名方法来完成签名。3. 把所有要发送给银联全渠道系统的域包括signature和signMethod，组成表单以POST方式送给银联全渠道系统前台交易的地址。4. 交易完成后，银联全渠道系统将把交易结果分别返回通知到商户通的前台应答地址和后台应答地址上，商户接收到交易通知后可分别调用“SDKUtil.convertResultStringToMap(应答报文);”方法进行应答报文解析，和“SDKUt
