资源描述
多应用开放平台金融应用接入修改历史姓名版本完成时间备注曹大峰0.0.12013-2-25初次建立该文档目 录1. 范围42. 术语43. 通讯方式44. 接口流程54.1. 多应用开放平台发起交易54.1.1. 应用下载54.1.2. 应用删除65. 接口描述75.1. WebService名字空间75.2. 接口列表75.3. 数据类型说明75.4. 数据域说明85.5. 消息类型描述105.5.1. PreOperationsReq105.5.2. PreOperationsReqResponse105.5.3. OperationResultNotify115.5.4. OperationResultNotifyResponse111. 范围本接口规范描述多应用开放平台与第三方业务平台进行的相关业务接口,主要进行功能说明及接口定义。2. 术语术语解释BOSSBusiness Operation Support System 业务运营支撑系统3. 通讯方式多应用开放平台与第三方业务平台采用SOAP/WebService方式进行通讯。多应用开放平台与第三方业务平台互相作为服务器供对方调用。4. 接口流程4.1. 多应用开放平台发起交易4.1.1. 应用下载正常流程:1、 用户在手机钱包客户端卡应用超市点击应用下载。2、 手机钱包客户端向多应用开放平台发送应用下载请求。3、 多应用开放平台向业务平台发起“预操作请求”(SessionType为1)。4、 业务平台审核用户下载请求,如果审核通过返回0000;否则返回错误码和错误信息,预处理响应中ProviderSessionID字段不能为空,该值由业务平台生成并保证唯一性。5、 多应用开放平台向手机钱包客户端返回写卡指令。6、 手机钱包客户端和多应用开放平台多次交互完成辅助安全域创建、辅助安全域初始密钥加载、SE应用下载、安装。7、 多应用开放平台向业务平台发起“SE操作反馈请求”,SessionID与“预操作响应”的ProviderSessionID一致。8、 业务平台返回结果。9、 下载应用客户端插件。10、 手机钱包客户端主界面显示新下载的应用图片。11、 用户点击卡片图片启动客户端插件。12、 用户在客户端插件中申请卡片。13、 客户端插件向银行后台发送用户申请请求。14、 通知用户申请通过。15、 用户再次进入客户端插件。16、 客户端插件从银行获取个人化数据对应用进行个人化。17、 完成应用下载。说明:1、 如果辅助安全域在SIM卡上已经存在,不会重复创建辅助安全域4.1.2. 应用删除1、 用户在客户端插件中发起注销卡请求。2、 银行业务平台处理用户注销卡请求,并通过客户端插件处理卡上余额。3、 用户在手机钱包客户端应用管理界面请求删除应用。4、 手机钱包客户端向多应用开放平台发送应用删除请求。5、 多应用开放平台向业务平台发起“预操作请求”(SessionType为2,SessionID为新生成)。6、 业务平台审核用户下载请求,如果审核通过返回0000;否则返回错误码和错误信息,预处理响应中ProviderSessionID字段不能为空,该值由业务平台生成并保证唯一性。7、 多应用开放平台向手机钱包客户端返回写卡指令。8、 手机钱包客户端和多应用开放平台多次交互完成SE应用删除。9、 多应用开放平台向业务平台发起“SE操作反馈请求”,SessionID与“预操作响应”的ProviderSessionID一致。10、 业务平台返回结果11、 手机钱包客户端删除应用的客户端12、 应用删除完成说明:1、 用户卡片个人化后未进行注销操作,银行业务平台应该在“预操作请求”时返回错误信息提示用户先进行注销,避免卡上有余额造成用户损失。2、 完成应用删除后如果辅助安全域中没有其他应用,将会删除该辅助安全域。5. 接口描述5.1. WebService名字空间名称uriSOAP-ENVhttp:/schemas.xmlsoap.org/soap/envelope/simotahttp:/www.chinamboile.com5.2. 接口列表接口名称消息类型(请求/响应)消息方向(发起方/被调用方)预操作请求PreOperationsReq/PreOperationsReqResponse多应用开放平台-业务平台SE操作反馈OperationResultNotify/OperationResultNotifyResponse多应用开放平台-业务平台5.3. 数据类型说明类型说明DEC10进制数字HEX16进制字符串,长度必须是2的倍数STRING字符串5.4. 数据域说明数据域数据类型备注最大长度simota:SynTypeDEC应用、安全域同步类型1:增加2:修改3:删除.1simota:AppAIDHEX应用AID及实例AID16simota:SEIDHEXSEID10simota:FileNameSTRING如果是应用、安全域同步,FileName为AppAIDsimota:FileContentHEX个人化数据64Ksimota:DomainAIDHEX安全域AID16simota:AppNameSTRING应用名称100simota:StatusCodeSTRING状态码4simota:StatusDescriptionSTRING状态描述60simota:SeqNumSTRINGyyyyMMdd24hmmssxxxxxx,xxxxxx为6位流水号 SeqNum与业务无关,应保证每个请求数据包中SeqNum的唯一性20simota:CommTypeDEC承载方式 1:SMS/BIP(后台客服人员WEB管理界面发起,终端用户短信、STK、WEB或WAP发起);2:应用管理器,3:终端客户端1simota:MsisdnSTRING手机号码20simota:OrgMsisdnSTRING原手机号码20simota:KeyVersionHEX密钥版本1simota:DomainKey节点安全域密钥simota:KeyIDHEX密钥ID2simota:KeyTypeHEX密钥类型2simota:KeyValueHEX密钥值32simota:KeyCheckHEX密钥校验码6simota:LockFlagDEC锁定标志0:解锁;1:锁定。1simota:ResultCodeSTRING卡端操作结果通知的返回代码 0x00,成功;其他失败。4simota:ResultMsgSTRINGSE操作结果通知的返回信息。60simota:TimeStampSTRING时间戳14simota:ImsiSTRINGIMSI15simota:Application节点应用simota:SecurityDomain节点安全域simota:OriginalCommandHEX源发起请求的命令字2simota:OriginalSeqNumDEC源请求包流水号20simota:SessionIDSTRING会话ID,即业务平台生成的业务会话ID,格式为 ZZZZZZZZZyyyyMMdd24hmmssxxxxxx,其中的ZZZZZZZZZ为9位的应用提供商编号,xxxxxx为6位流水号同一业务的数据包应使用相同的SessionID26simota:ProviderSessionIdSTRING发起方调用时传递的SessionID26simota:SessionTypeDEC1:应用下载/业务订购,2:应用删除/业务退订,3:应用更新/业务更新,4:业务迁移,5:应用锁定,6:应用解锁,7:安全域创建,8:安全域删除,9:安全域密钥更新,10:个人化数据管理,11:BOSS换号simota:TARHEX应用或安全域的TAR3simota:IsDeleteCAPFileDEC是否删除CAP文件 0:不删除;1:删除1simota:CmdTypePersoTypeDEC0:方式一,读写个人化数据2:方式二,应用调用安全域个人化3:方式三,安全域调用应用个人化1simota:EndflagDEC0:未完 1:结束1simota:APDUSumHEX已执行APDU指令数1simota:LastAPDUSWHEX最后一条APDU执行结果SW2simota:LastDataHEX最后一条指令的执行返回数据256simota:ModuleInfo节点Module信息simota:CardPOR节点卡片返回信息simota:ProvnCodeSTRING省份代码4simota:IfContinueOptDEC是否还有后续操作0:无1:有后续操作simota:AppProviderCodeSTRING应用提供商代码6simota:TokenHEX完成签名的Token数据simota:HashValueHEX待签名的哈希数据simota:EventIDDEC1、用户退网2、业务退订3、业务订购4、SE挂失simota:UserStatusDEC用户状态1、预销户退订2、销户退订3、过户退订4、改号退订5、欠费停机6、用户挂失停机7、用户主动停机8、续费恢复9、解挂后恢复10、主动停机后复机11、业务开通确认simota:Personalization节点个人化数据5.5. 消息类型描述5.5.1. PreOperationsReq父元素名称元素名称约束备注SOAP-ENV:Body simota:PreOperationsReq1simota:PreOperationsReqsimota:SeqNum1simota:PreOperationsReqsimota:SessionID1simota:PreOperationsReqsimota:SessionType1simota:PreOperationsReqsimota:TimeStamp1simota:PreOperationsReqsimota:CommType1simota:PreOperationsReqsimota:Msisdn1simota:PreOperationsReqsimota:SEID1simota:PreOperationsReqimota:IMEI 1simota:PreOperationsReqsimota:AppAID1simota:PreOperationsReqsimota:OrgMsisdn0.1在BOSS换号时设置5.5.2. PreOperationsReqResponse父元素名称元素名称约束备注SOAP-ENV:Body simota:PreOperationsReqResponse1simota: PreOperationsReqResponsesimota:SeqNum1simota: PreOperationsReqResponsesimota:TimeStamp1simota: PreOperationsReqResponsesimota:Status1simota: Statussimota:StatusCode1为0000时,表示业务平台通过审核,继续后续请求操作。返回其他状态时,操作终止。simota: Statussimota:StatusDescription1simota: PreOperationsReqResponsesimota:ProviderSessionId1业务平台调用操作时生成的SessionID5.5.3. OperationResultNotify父元素名称元素名称约束备注SOAP-ENV:Body simota:OperationResultNotify1simota:OperationResultNotifysimota:SeqNum1simota:OperationResultNotifysimota:SessionID1simota:OperationResultNotifysimota:SessionType1simota:OperationResultNotifysimota:TimeStamp1simota:OperationResultNotifysimota:OriginalSeqNum1源请求包交易序号simota:OperationResultNotifysimota:Msisdn1simota:OperationResultNotifysimota:SEID1simota:OperationResultNotifyimota: AppAID0.1simota:OperationResultNotifysimota: ResultCode1simota:OperationResultNotifysimota: ResultMsg1simota:OperationResultNotifysimota: Imsi0.1simota:OperationResultNotifysimota: CardPOR1simota: CardPORsimota: APDUSum1simota: CardPORsimota: LastAPDUSW1simota: CardPORsimota: LastData1simota: CardPORsimota: LastApdu15.5.4. OperationResultNotifyResponse父元素名称元素名称约束备注SOAP-ENV:Body simota:OperationResultNotifyResponse1simota:OperationResultNotifyResponsesimota:SeqNum1simota:OperationResultNotifyResponsesimota:TimeStamp1simota:OperationResultNotifyResponsesimota:Status1simota: Statussimota:StatusCode1为0000时,表示业务平台通过审核,继续后续请求操作。返回其他状态时,操作终止。simota: Statussimota:StatusDescription1simota:OperationResultNotifyResponsesimota:IfContinueOpt1填0
展开阅读全文