mbs-t android客户端第三方集成支付类

1、客户端项目Android 客户端第说明书管理部广州开发中心项目组2011 年 7 月修改本文档中所包含的信息属于信息，如无中国建设的，任何人都无权或利用。Copy Right 2010 by China Construction B日期描述版本作者审核发布日期120110707文档建立V1.0目录1引言4编写目的4项目背景4适用范围42实现说明43整合应用相关要求53.13.23.33.43.53.6系统结构要求5代码合并要求5应用启动要求6应用退出要求6UI要求7通讯要求74支付接口相关要求84.14.24.34.4启动支付8参数9启动返回接口10返回接口参数115第注意要点121 引言编写

2、目的本说明书为 Android 客户端集成第应用程序代码提供接口规范说明，以的接口规范要求，进行扩展客户端的第应用程序集成，方便后续的扩展开发以及等工作。项目背景客户端在已实现“”功能的基础上，需要集成第应用，如“票”、第金融工具等，以扩展客户端程序的功能，提高相应的使用性和应用范围。适用范围团队 Android 客户端项目。项目开发。包括程序员、高级程序员、架构设计师。第应用程序相关。2 实现说明客户端整合第应用程序是将第应用程序代码整合到客户端程序，用户在客户端使用第应用程序功能时，客户端进行启动第应用程序的界面，具体流程如下描述。1、第提供相应符合规范的程序代码。2、客户端把第提供的程序

3、代码合并到客户端代码中，作为客户端程序的一部分。3、用户使用客户端过程中，调用第应用程序功能，启动第应用程序界面。3 整合应用相关要求3.1 系统结构要求1、第应用必须是基于 Android 系统的应用程序代码，采用的系统架构、UI 架构都是基于 android 系统 Framework 实现的。2、第应用的 SDK 版本必须是在 2.0 到 2.3 之间（因为这些版本 SDK 变化不大，出于程序稳定考虑采用这些版本）。3.2 代码合并要求1、 第应用程序代码存放的包名必须唯一，不能和客户端现有程序或者其他第应用程序的包重名（ 建议第 应用的包命名，即AndroidManifest 中指定的包

4、命名）。2、 第应用程序使用的所有资源（素材，相应布局文件，颜色定义，字符串定义等）名称应该添加自己的前缀标识，或者使用子目录存放资源方式，用于和客户端或其他第应用的系统资源文件相区分。例如 logo素材可以如下定义：功能资源前缀资源子目录应用 1ccb_应用 1_logo.pngccb/应用 1/logo.png3、 标明 AndroidManifest.xml 整合时需要注意的要点，如第自定义了哪些权限，控制了特殊的界面布局属性等。3.3 应用启动要求为保证用户使用 home 键或者接听等情况切换出整个客户端程序后，重新返回使用客户端时，能够即可返回到用户离开前的应用，建行客户端启动第三方

5、应用程序时是以任务模式启动，采用的是建行客户端自定义的任务管理对象TaskManager，调用方法如下：TaskManager tsm = new TaskManager(mContext); tsm.changeTask(任务名);所以第应用程序需向客户端提供启动Activity 名称和任务名称（任务名称建议使用第程序包名），第Activity 名称在 tsm.changeTask方法中使用，代码如下：另外客户端启动第应用是以新起任务方式启动，要求第明确指定Activity 所属的任务名，即在 AndroidManifest.xml 配置 Activity 时指定 taskAffinity属

6、性，并且需要保证该属性值具有唯一性，以区别其他第应用程序。3.4 应用退出要求第应用程序整合到客户端后，属于客户端部分应用程序，所以需要在客户端退出的时候，第应用程序也需要完全退出。客户端程序在用户确认退 出 的 时 候 ， 会 发 送 一 个 关 闭 广 播 ， 广 播 的action属 性 值 为“com.chinamworld.main.CLOSE_CLENT”，广播不带任何相关数据；要求第三ent tent = newent();tent.setFlags(ent.FLAG_ACTIVITY_NEW_TASK); t ent.setClass(mContext,x.class); mC

7、ontext.startActivity(tent);应用 2ccb_应用 2_logo.pngccb/应用 2/logo.png方应用程序实现相应广播器，在接收到广播后直接关闭第应用程序。另外，由于启动的使用时用任务管理 TaskManager 启动的，所以第应用程序退出时（无论是正常退出还是异常【无通信等】退出）都必须调用关闭建行客户端任务管理中相应的任务，防止建行客户端自动切换回该任务，代码如下： TaskManager tsm = new TaskManager(mContext); tsm.finishRunningTask(任务名);这里的任务名必须与启动时定义的一致。注意：该广播

8、是建行客户端退出时发送的广播，第应用程序负责接收该广播执行退出。但第应用程序本身退出返回建行客户端时，不能发送该同名的广播，造成整个客户端退出。3.5 UI 要求1、第应用程序的UI部分由程序提供方进行设计实现，但风格等因尽可能参照客户端程序，如标题栏可参考如下，水平/垂直居中。2、所有 UI 要求支持 480*800，320*480，240*320，640*960,720*1280 等几种分辨率，以适应不同分辨率的 android。3、使用客户端提供的背景，作为第应用程序的背景。3.6 通讯要求根据客户端当前的通讯情况，第应用程序应支持 WIFI、2G、3G 通讯，并且除了 WAP 接入点还

9、应当支持 NET 接入点。4 支付接口相关要求4.1 启动支付第应用程序需要支付时调用建行客户端相关的支付功能接口，接口分B2C、C2C 两种方式。B2C 方式，B2C 方式是指用户确认支付的界面时以 Webview 加载网页方式实现的，并且支付成功后的成功界面也是以 Webview 重载连接的方式。该方式启动支付模块时生成的接口对象调用方法如下：public CCBPay_erface_Tool(Context context, String ord WebView result) context：表示上下文对象aram,ordaram：表示支付参数以“key1=value1,key2=va

10、lue2,key3=value3”方式拼接的字符串对象result：支付成功后需要重载网页的 Webveiw 对象然后生成的接口对象调用启动支付接口方法：public void startCCBPayM() C2C 方式，是指用户确认支付的界面时用 Activity 方式展现，并且支付成功时采用 Activity 显示的。该方式启动支付模块时生成的接口对象调用方法如下：public CCBPay_erface_Tool(Context context, String ordaram,Class result) ordaram：表示支付参数以“key1=value1,key2=value2,ke

11、y3=value3”方式拼接的字符串对象result：支付成功后需要显示结果处理的 Activity 界面对象然后生成的接口对象调用启动支付接口方法：public void startCCBPayM()4.2参数下表为商户或第应用在使用支付时的接口参数规范。注：商户要保证订单号的唯一性,非参数值可不填。: 通过以下的数值字符串拼接后计算出来：TXCODE+MERCHANTID+ ORDERID+ PAYMENTMD5ONCE mac = new MD5ONCE(TXCODE+MERCHANTID+ ORDERID+PAYMENT);mac.calc();=mac.toString();提交的参

12、数名称参数说明最大长度（char）是 否 必输备注TXCODE交易码6Y由建行分配为SP7010。WAPVERWAP 版本6N默认为 1.2。MERCHANTID商户代码20Y由建行指定ORDERID订单号30Y商户需要保证订单号的唯一性PAYMENT付款金额16Y：元如：11.88Md5 摘要串32YBRANCHID分行代码9N由建行指定ID商户柜台代码9N由建行分配，缺省为000000000CURCODE币种2N缺省为 01（只支持支付）REMARK1备注 132N汉字为 UTF-8 编码REMARK2备注 232N汉字为 UTF-8 编码字段的生成请参照附件4.3 启动返回接口用户在支付

13、完成后，进行“通知商户”操作，建行客户端获取相应数据，关闭客户端支付模块功能，把参数传递给第应用，即调用启动时生成CCBPay_erface_Tool 对象的返回方法：B2C 方式启动时返回调用接口为：public void setBackResult(Context context, String backParams) context：表示上下文对象backParams：为支付结果返回的接口参数，“key1=value1,key2=value2,key3=value3”方式拼接的字符串对象，并且使用调用B2C 支付接口时指定的Webview 对象result直接 loadUrl 重新加载。

14、C2C 方式启动时返回调用接口为：public void setBackResult(Context context, HashMap backParams) context：表示上下文对象backParams：为支付结果返回的接口参数，并且使用以下ent 方式传送给相应启动 C2C 方式时指定的 result 接收处理的 Activity。entent = newent();ent.putExtra(key,value);具体传递参数如下节（4.4 返回接口参数）所示。4.4 返回接口参数下表为支付模块完成支付订单处理，返回给商户或第应用的参数规范。支付签名由以下字段顺序连接起来成一字符串，

15、然后通过约定的提交的参数名称参数说明最大长度（char）是 否 必输备注CHANNEL支付标识1N支付标识：1-客户端支付，其它-wap 支付MERCHANTID商户代码20Y商户在支付的代码ID商户柜台代码20YBRANCHID商户在的分行代码30YORDERID订单号30YPAYMENT交易金额16Y：元 可以带小数点REMARK1备注 132YREMARK2备注 232YBJOURNAL流水号30YDN号码11NSUCS支付成功标志1YY ： 成功， N ： 失败，U ： 交易不确定SIGNB系统出具的电子签名256YUSERNAME客户50N此字段默认不返回；如需返回，需要联系分行在商

16、户管理 配置返回开关。O支付账号30N此字段默认不返回；如需返回，需要联系分行在商户管理 配置返回开关。算法对该串进行计算得出：MERCHANTID + ORDERID + PAYMENT + BJOURNAL + SUCS注：字符串中变量名必须是大写字母。5 第注意要点1、 向客户端提供：应用程序源码、素材、布局文件资源等。2、 程序/资源命名：第应用程序的包命名、资源命名、类名等应有相应的含义和唯一性，即需要标明所属的第应用程序和对应的功能等。3、 Activity 要求：指定所属任务属性 android:taskAffinity；为风 格 ， 指 定 界 面 样 式 为 不 包 含 标 题 栏android:theme=android:style/Theme.NoTiar；关闭横竖屏切换功能，只支持竖屏 android:screenOrienion=nosensor；不显示在home 或程序列表中，即具有启动界面不能带有不显示在最近启动程序中（长按 home