《招行面向互联网商户接口开发指南 - 有密支付.doc》由会员分享，可在线阅读，更多相关《招行面向互联网商户接口开发指南 - 有密支付.doc（41页珍藏版）》请在金锄头文库上搜索。
1、 内部资料 注意保密招行面向互联网商户接口开发指南修订历史修订描述版本日期作者审核新建1.0徐文晖这次更新内容： 1、iOS密码键盘部分内容更新； 2、增加了商户开发包使用的常见问题解答文档； 3、更新了手机端签约的接口内容；4、基于开发同事前期的批注修改内容补充。1.1项目开发组1、iOS密码键盘部分修改了商户调用密码键盘的方式。1.2项目开发组1、在六、API列表的签约功能里，增加了前端交互处理部分内容。签约成功界面“返回商户”按钮和页面头部导航技术方案约定，以前的文档由于还没有制定方案，所以缺失。 2、在六、API列表的签约功能里，增加了注意事项部分内容。让商户对秘钥、地址之类通过配置管
2、理，防止将来变动，不用发布程序。1.3项目开发组1、增加招行面向互联网商户接口开发指南文档目录。2、支付接口功能的参数部分修改成以表格形式展现。3、涉及到具体接口参见“列表”里的“功能”，修改成链接的方式，点击后可以直接跳转。1.4项目开发组6.2 SDK集成指引有所调整1.5朱楠辉、李海涛6.2.2 增加测试商户地址1.6张樟、李海涛补充6.1签约功能-前端交互处理1.7胡明艳、李海涛修改4.2参数定义和六、2.2商户支付命令中的： 返回商户url（MerchantRetUrl）1.8张樟、李海涛增加“六、2.3节，页头导航及返回”章节，介绍“返回机制”1.9张樟、李海涛六 API列表：1
3、签约功能，增加测试环境短信验证码获取1.10张樟、李海涛六API列表：6密码键盘SDK功能 Ios版说明一、使用方法中的第2点，包含的头文件改了#import 改成： #import #import 二、使用方法中的第3点，在后面加了一句：若图片没有加载，则显示的密码键盘页面是透明的 三、使用方法中的第4点 的第一行，加了一句： 需重写webView方法， 四、公钥配置说明中，在CMBPublicKey后增加了一行： 公钥内容 指明公钥是以string的形式。 1.112016.4.26林雪燕、李海涛目 录招行面向互联网商户接口开发指南1一、指南说明51.阅读对象52.版本说明5二、术语51.
4、支付模式52.名词解释5三、一网通支付申请流程61.开户流程62.一网通支付业务开户所需资料6四、接口规则61.协议规则72.参数规定73.安全规范9五、一网通支付（主动）91.场景介绍92.业务流程及开发步骤支付步骤15六、API列表161.签约功能162.主动支付接口功能213.签约结果回调功能284.解约功能285.主动支付退款功能296.密码键盘SDK功能337.程序定单管理功能37七、联系人员40一、 指南说明1. 阅读对象本文适用于互联网商户系统(如交通出行平台、在线购物平台、自动化智能收银系统或其他)集成招商银行一网通支付涉及的技术架构师，研发工程师，测试工程师，系统运维工程师。
5、2. 版本说明1. 2016.1.19新增此接口开发指南。二、 术语1. 支付模式商户APP在应用内调用招行H5页面完成一网通支付。2. 名词解释一网通支付：是招行银行全新推出的移动端无卡支付工具，支持用户在商户的移动客户端内进行多银行卡支付（12家银行储蓄卡，10家银行信用卡），流程便捷，实时到账。密码键盘SDK：招行自主开发的基于Android和iOS平台的安全输入键盘，集成在商户APP中，配合招行一网通支付使用，保护用户的密码安全。三、 一网通支付申请流程1. 开户流程1、电子支付特约商户结算账户开户支行或分行零售银行部负责商户的资料收集、受理、验证并向分行零售银行部提交商户接入申请，分
6、行零售银行部队电子支付特约商户进行市场调查，并验证相关证件，由分行零售银行部初步评估后，协助商户填报电子渠道特约商户开户审批表、招商银行一网通支付业务合作协议书（见附件），报分行零售银行部审批；2、分行零售银行部按照一网通支付商户建设流程进行商户开户申请；3、需要提供8位的企业网银编号；4、按照总行相关流程申请中间业务平台商户号、开通协议支付、明确是否需要支持退款。2. 一网通支付业务开户所需资料营业执照副本或组织机构代码证副本、法定代表人或负责人身份证件、经办人身份证件及企业授权书、互联网信息服务业务经营许可证（ICP证）（国家不要求具备ICP证的商户不需提供），以上资料分行应留存复印件。四
7、、 接口规则用户通过手机浏览器浏览商户商城生成定单支付页面，支付页面应包括：定单内容和招商银行一网通支付按钮。招商银行一网通支付按钮通过支付命令链接到支付网关。商户需要自行对客户协议开通状况、协议号等信息进行管理)。在客户协议未开通的情况下，需要填写开通协议相关的信息，以保证银行页面能正确引导客户进行协议开通并完成支付。1. 协议规则传输方式传输安全控制手段采用的是安全套接层SSL。提交方式支付系统支持GET方式和POST方式提交支付命令，建议使用POST方式2. 参数规定参数名称参数说明支付商户开户分行号请咨询开户的招商银行分支机构支付商户号6位长数字，由银行在商户开户时确定定单号6位或10
8、位长数字，由商户系统生成，一天内不能重复定单总金额格式为：.元交易日期格式：YYYYMMDD与实际时间只能有一个小时误差。商户交易日期。日期不能跨天。如果交易日期为前一天，则要求截至时间为凌晨1点钟。如果交易日期为后一天，当前时间必须为23点以后定单过期时间跨度必须为大于零的整数，单位为分钟。该请求参数为可选参数，如果请求中不包含该参数，则默认为会话有效时间（目前是30分钟）(如果客户在商户端对同一笔订单重新发起支付请求，则以商户在后一次发起时指定的参数为准。)该参数指定当前支付请求必须在指定时间跨度内完成，否则按过期处理。该参数适用于航空客票等对交易完成时间敏感的支付请求；支付结果通知命令U
9、rl支付结果通知命令中参数之前的部分，长度不能超过128个字节。例如： = http:/ MerchantRetPara = Para1=abc|Para2=123则，点击“返回按钮”，客户浏览器将跳转到：http:/ 注意：MerchantRetPara参数可为空，商户如果需要不止一个参数，可以自行把参数组合、拼装，但组合后的结果不能带有&字符，总长不能超过128个字节返回商户参数详见上文的返回商户url中的说明客户协议号字符串，不超过30位。未签约客户，填写新增的协议号，用于协议开通；签约客户，填写客户协议号。非空。客户协议号是商户自己生成的，纯数字0,9即可，无其他特殊要求交易时间戳交
10、易日期+时间，格式为YYYYMMDDHHMMSS。非空协议商户企业编号由银行在商户开户时确定。非空, 8位。协议开通请求流水号字符串，不超过20位。协议开通时非空协议用户ID字符串，不超过20位协议手机号11位数字协议开通结果通知URL协议开通结果通知命令中参数之前的部分。参数规则同支付结果通知命令。字符串，长度不超过100位。协议开通时非空协议开通结果通知参数商户需要银行在协议开通结果通知中转发的商户参数，参数规则同支付结果通知命令。字符串，长度不超过128位地理位置格式为“经度|纬度”，经纬度两个参数之间用竖线分开。例如：18.23445|46.000033。可以为空客户风险等级保留字段。
11、填写商户端客户的风险等级，可以为空3. 安全规范支付接口安全规范见商户校验码.doc。五、 一网通支付（主动）1. 场景介绍商户已有客户端，用户在商户APP内发起购买操作时，可以调用一网通支付完成下单付款的流程。l 首次支付：需一次性完成 签约+支付两个流程。步骤（1）：用户完成选购，商户在收银台向用户提供“银行卡支付”选项。步骤（2）：用户选择“银行卡支付”，调起招行接口，跳转至银行卡号输入页面。步骤（3）：用户输入银行卡后，点击下一步，继续填写姓名、证件号、手机号等信息。步骤（4）：验证用户填写的信息，并向用户提供的手机号发送短信验证码进行验证。步骤（5）：如果用户已经是招商银行一网通用户
12、，则引导用户输入支付密码进行验证。如果用户尚未开通招商银行一网通用户，则为用户开通并引导用户设置支付密码。至此完成签约，商户后台得到签约成功的通知。步骤（6）：用户输入支付密码，完成支付。商户后台得到支付成功的通知。 （以上图片为示意）l 已签约用户再次支付：只需输入支付密码即可完成支付。步骤（1）：用户完成选购，商户在收银台向用户提供“银行卡支付”选项。步骤（2）：用户输入支付密码，完成支付。商户后台得到支付成功的通知。 2. 业务流程及开发步骤支付步骤商户APP在应用内调用招行H5页面完成一网通支付，商户系统和招行一网通支付系统主要交互说明：步骤1：用户在商户APP中选择商品，提交订单，选择“银行卡支付”后调用招行一网
