翼支付客户端支付应用接入指南

翼支付客户端支付应用接入指南（HTML5应用开发）版本历史目录本文阅读对彖为中国电信翼支付客户端合作商户的产品开发、研发相关技术人员。

2使用用途本文介绍在HTML5平台开发符合标准的支付应用并与翼支付客户端集成的技术细节，帮助商户将其业务与翼支付客户端系统对接。

3名词解释4接入流程1、中请接入：配置测试环境和网关商户编码；2、接入测试：应用方发【应用接入】测试版本安装包到我方产品经理进行测试环境配置，邮件格式见：3、我方产品经理通知运营进行应用配置；4、接入测试：测试环境配置完成之后通知应用方测试，回复【应用接入】邮件“测试环境配置完成”，同时发送客户端测试安装包；5、接入测试：应用提供方发【测试报告】，（测试报告中需包含测试用例）邮件到我方产品经理；6、功能验收测试：我方根据提供的测试报告进行验收测试，并岀具测试报告；7、接入生产环境：验收测试通过后，通知生产上线准备，接入生产测试：8、接入生产测试：生产环境配置完成之后通知应用方生产即正式环境测试，回复【应用接入】邮件“生产环境配置完成”；9、应用提供方发【测试报告】邮件到我方接口人；10、接入生产测试：我方根据应用方提供的生产测试报告进行验收测试，并岀具测试报告；11、功能测试：通过之后请产品部进行产品体验；12、前置审核：产品体验和功能验收测试通过之后需要应用方根据“客户端客服知识库内容规范”和“客户端知识库及客服解释脚本模板0605”提供产品手册和客服脚本, 由产品经理审核完成之后安排内部客户体验；12、体验完成之后通知市场部，由市场部完成上线流程并开放给普通用户。

5交互流程6接口说明客户端侧接口HTML5本地接I I函数库，定义了支付应用与翼支付客户端原生应用本地之间的交互接I Io根据支付应用场景抽象出通用的类库，如用户信息、应用、对话框、通讯录、扫一扫、支付模块等等。

详见。

服务器侧接口支付应用平台与网关平台间采用http方式通信，见文档【翼支付移动收银台支付接口开发包标准版-3节】。

7开发调试7.1翼支付提供的资源7.1.1翼支付客户端连接翼支付生产环境的客户端版本。

（可自行到官网下载）7.1.2 商户ID我们为所有翼支付客户端的合作商户分配一个专有的网关商户ID,作为商户的标识。

7.1.3翼支付账号开通应用配置到测试环境后，合作商户的手机号码开通翼支付账户，充值并下发支付密码，供开发测试使用。

7・2商户准备的资源7. 2.1翼支付账号f合作商户需在翼支付客户端注册开通翼支付账号(支持多个)，提供给翼支付运营进行账号配置。

7. 2.2 H5 站点合作商户开发的H5应用(远程站点)，用于展示合作商户的业务，将应用地址提供翼支付运营进行应用配置。

7. 2.3支付应用平台合作商户开发的支付应用平台，与翼支付网关环境对接，进行订单生成，接收并响应支付结果。

7・3商户进行H5开发使用账号登录翼支付客户端，即可在首页(或者首页更多页)看到商户自己的应用，进行页面H5应用开发，如需使用翼支付客户端侧接口(如支付)，在页面嵌入即可。

7. 4注意事项应用首页必须回退到翼支付大厅，必须使用翼支付，且只能使用翼支付，不可使用其他第三方支付工具。

翼支付客户端H5应用容器的topbar区域属于native,默认情况卞，左上角返回按钮的事件为退出当前H5应用，建议商户在自己的H5应用内用topbar控制页面返回。

=function(){(true); 〃返回按钮事:件交由页面js处理(function(event) {if (event == 'backpress') {//触发返回按钮事件(对android来说，包括物理返回键)〃在应用首页的代码：()；8提交测试提交测试报告支付应用开发完成并配置到测试环境/生产环境后，需提交测试报告，表明支付应用己具备上线集成测试基础。

测试报告需涵盖支付应用主要功能用例，包括完整的支付流程测试。

测试报告需要以邮件的形式反馈【测试报告】【应用名称】测试环境/生产环境测试报告附件：测试报告模板。

见〃［应用需称］［终端平台］［应用版本］测试报告—模板.Xlsx\ 此测试报告模板的中订单支付用例必须测试，且需要提供订单支付手机截图，其他应用功能测试用例请应用提供方补充并完成测试。

9客户端侧接口定义9・1用户接口(User)9. L 1 获取产品号- getProduct(2)无⑶应答参数返回值：返回用户产品号的字符串。

⑷调用实例$_id( ,,phone_edit") .value = User..();9. 2应用信息及操作(App)9. 2.1设置顶部标题-setTitle(1)接口描述(3) 无 ⑷调用实例 (”商品详情9. 2. 2 获取客户端版本号一 getClientVersion(1)接口描述接口名称无⑶应答参数(4)客户端人厅版本号字符串，如调用实例0;9. 2. 3 打开浏览器窗口一openBrowser (1)(2)字符串，url⑶应答参数无⑷调用实例App. open Browser9.2・4 截断返回键-overrideBackPressed无(8) 调用实例App. overrideBackPressed(tr'ue);9. 2. 5 功能页面跳转 - jumpToNativeView⑴接口描述(3)(4)调用实例App. jumpToNative ("BindCard")9. 2. 6 支付密码安全输入- openSaf©Keyboard (1)接口描述(3)无(4)调用实例(6，””，function(pwd){}j function(){})9. 2. 7获取登录会话码一getSessionKey (1)无⑶应答参数返回值：返回sessionKey⑷调用实例App・ getSessionKey ();9. 2. 8 设置头部隐藏显示- setHeaderVisible(8)调用实例App. setHeaderVisible (false);9. 2. 9登录会话码续期- autoLogin (1)接口描述无(3)应答参数返回值：回调函数中返回新的sessionKey⑷调用实例App. autoLogin (function(sessionKey){lf(sessionKey != ""){=lastAddress;}9. 2.10 获取网络类型-getNetworkType (1)接口描述⑶应答参数返回值：网络连接类型[2g/3g/4g/wifi](4)调用实例var nt =();9. 2.11获取用户地区码-getLocation⑴接口描述无⑶应答参数地区码好(4)调用实例var locationCode =();9. 2.12退出当前应用- exitApp⑸接口描述⑹请求参数无⑻调用实例$(r,#exitApp w) click9. 3 通信接口(Contacts)9. 3.1 打开联系人-openContacts (1)接口描述(3)无。

所读取的联系人返回值通过回调函数获取。

(4)调用实例function(ph one_no){$_id("phone_edit")・value = phone_no;function(error){})；9. 3.2打电话- tel(1)接口描述返回值：返回空字符串。

(4)调用实例$_id("teleservice").onclick = function(){ 0；9・4原生对话框(Dialog)9. 4.1俄弹出等待对话框一showProgressDialog(1)接口描述返回值：返回对话框句柄标识字符串。

(4)调用实例var dialog^id = Dialog. showProgressDialog ('提示"/IE在加载业务数据,请稍候，)；9. 4. 2 关闭等待对话框- dismissDialog无⑷调用实例Dialog・ dismissDialog(dialog_id);⑴⑶alert(係统繁忙，请稍后再试」);9. 4.3关闭所有弹出的对话框- closeDialog (1)接口描述无(3)应答参数无(4)调用实例Dialog・ closeDialog();9. 5 扫描接口(Scanner)9. 5. 1扫描条码二维码- scan无(4) 调用实例var success_callback = function(){ost(URLj params, submit_callback);}；/***订单提交应答回调函数*@param result -支付应用后台下单接口返回结果*/function submit_callback(pay3son) {if (SUCCESS) {落款注：开头、落款自定义示例:邮件主题:【应用接入】【当当网】Andriod平台测试版本邮件正文:您好!附件为当当网Andriod平台测试版本安装包,相关信息如下:应用名称:当当网应用地址:MD5 签名：xxxx其他未改动落款附件:zip9.6产品经理邮件要求产品经理收到第三方应用程序的接入请求后，通知翼支付技术人员把应用地址封装为可配置的包，并提交运营配置。

应用程序包名：不限应用程序版本：应用程序版本由翼支付技术人员提供默认版本号为（）MD5：MD5由翼支付技术人员提供。