招行面向互联网商户接口开发指南 - 有密支付.doc

内部资料 注意保密 招行面向互联网商户接口开发指南 修订历史 修订描述 版本 日期 作者 审核 新建 1.0 徐文晖 这次更新内容： 1、iOS密码键盘部分内容更新； 2、增加了商户开发包使用的常见问题解答文档； 3、更新了手机端签约的接口内容； 4、基于开发同事前期的批注修改内容补充。 1.1 项目开发组 1、iOS密码键盘部分修改了商户调用密码键盘的方式。 1.2 项目开发组 1、在六、API列表的签约功能里，增加了前端交互处理部分内容。 签约成功界面“返回商户”按钮和页面头部导航技术方案约定，以前的文档由于还没有制定方案，所以缺失。 2、在六、API列表的签约功能里，增加了注意事项部分内容。 让商户对秘钥、地址之类通过配置管理，防止将来变动，不用发布程序。 1.3 项目开发组 1、增加《招行面向互联网商户接口开发指南》文档目录。 2、支付接口功能的参数部分修改成以表格形式展现。 3、涉及到具体接口参见“XX列表”里的“XX功能”，修改成链接的方式，点击后可以直接跳转。 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 签约功能，增加测试环境短信验证码获取 1.10 张樟、李海涛 六API列表：6密码键盘SDK功能 Ios版说明 一、使用方法?中的第2点，包含的头文件改了 ????????#import cmbkeyboard/CMBWebViewController.h?改成： ?#import cmbkeyboard/CMBWebKeyboard.h? ?#importcmbkeyboard/NSString+Additions.h ? ????二、使用方法?中的第3点，在后面加了一句：?若图片没有加载，则显示的密码键盘页面是透明的 ???? ???? 三、使用方法?中的第4点 的第一行，加了一句： ?需重写webView方法， ???? ????四、公钥配置说明中，在keyCMBPublicKey/key后增加了一行： ?string公钥内容/string ????指明公钥是以string的形式。 1.11 2016.4.26 林雪燕、李海涛 目 录 TOC \o 1-3 \h \z \u 招行面向互联网商户接口开发指南 1 一、 指南说明 5 1. 阅读对象 5 2. 版本说明 5 二、 术语 5 1. 支付模式 5 2. 名词解释 5 三、 一网通支付申请流程 6 1. 开户流程 6 2. 一网通支付业务开户所需资料 6 四、 接口规则 6 1. 协议规则 7 2. 参数规定 7 3. 安全规范 9 五、 一网通支付（主动） 9 1. 场景介绍 9 2. 业务流程及开发步骤—支付步骤 15 六、 API列表 16 1. 签约功能 16 2. 主动支付接口功能 21 3. 签约结果回调功能 28 4. 解约功能 28 5. 主动支付退款功能 29 6. 密码键盘SDK功能 33 7. 程序定单管理功能 37 七、 联系人员 40  指南说明 阅读对象 本文适用于互联网商户系统(如交通出行平台、在线购物平台、自动化智能收银系统或其他)集成招商银行一网通支付涉及的技术架构师，研发工程师，测试工程师，系统运维工程师。 版本说明 2016.1.19 新增此接口开发指南。 术语 支付模式 商户APP在应用内调用招行H5页面完成一网通支付。 名词解释 一网通支付：是招行银行全新推出的移动端无卡支付工具，支持用户在商户的移动客户端内进行多银行卡支付（12家银行储蓄卡，10家银行信用卡），流程便捷，实时到账。 密码键盘SDK：招行自主开发的基于Android和iOS平台的安全输入键盘，集成在商户APP中，配合招行一网通支付使用，保护用户的密码安全。 一网通支付申请流程 开户流程 1、电子支付特约商户结算账户开户支行或分行零售银行部负责商户的资料收集、受理、验证并向分行零售银行部提交商户接入申请，分行零售银行部队电子支付特约商户进行市场调查，并验证相关证件，由分行零售银行部初步评估后，协助商户