通用业务平台接口报文规范.doc

通用业务平台接口报文规范V1.0.3上海新大陆翼码信息科技有限公司二零零七年四月前 言目前有很大一部分业务商由于自身能力或者投入的问题,需要同时接入电子回执平台和验证代理平台，这样就需要和两个平台联调,增加了工作量。为了降低业务商的接入门槛,故开发通用业务平台来解决这一问题.本规范规定了通用业务平台与服务提供商相关设备之间的通信接口，是服务提供商相关设备需要遵从的技术文件。目 录系统功能4系统结构图4结构说明4联机交易5生成委托交易6请求6响应8委托冲正交易9请求9响应9委托撤销交易10请求10响应10查询交易11请求11响应11回执转发交易13请求13响应13回执重发交易14请求14响应14回执去图片交易15请求15响应15批次数据同步16请求16响应17验证数据同步17请求17响应18数字签名(保留)19系统功能系统结构图业务服务商通用业务平台验证代理系统Online电子回执平台识读设备http/https结构说明对于接入的业务服务商,可以通过http或https方式接入通用业务平台,然后由通用业务平台将数据同步到回执平台和验证代理系统.然后由验证代理系统完成最终的数据还原和业务展现.联机交易接入接口的请求和响应采用XML作为具体业务报文的载体，请求为POST方式，参数名为：xml，传输时的charset需要设置为GB2312。报文格式如下： request_type organization req_seq user_idfield1说明： XML元素类型意义说明encoding字符集报文的字符集编码目前仅支持GB2312business_trans通用业务平台交易标志，交易XML包的根标记，所有交易的内容必须位于此标注内version为本接口规范版本号request_type字符串交易类型，其值可能为：generated_commission_requestcommission_cancel_requestcommission_reversal_requester_resend_request er_resend_nopic_request er_sendto_request query_request请求为request响应为response此类型和后面的request_type_name必须一致organization16位数字串机构码,在接入前由平台管理员分配16位数字req_seq数字串请求流水号,每次交易流水号必须不同32位request_type_name随交易定义每个交易的不同参数此标注数据、名称和元素类型均据命令不同来定义生成委托交易交易用途:通用业务平台最重要的一个交易,条码的生成及验证的数据均由此交易来产生交易名称: generated_commission_request请求交易请求数据包格式如下:generated_commission_request1234567890123456111user_id123456789011396092919913960929199NOKIA000info_titlecontent notesmms_notes2008080819300012345678901234567890print_text1010123456789012345678901234567890122响应交易响应报文如下:generated_commission_response000000000244113200704050101040000成功委托冲正交易交易用途:当生成委托交易没有收到平台明确响应或平台超时时,使用这个交易来取消上笔交易.交易名称: commission_reversal_request请求commission_reversal_request1234567890123456118user_id111响应commission_reversal_response000000000244113200704050101030000成功委托撤销交易交易用途:当客户主动要求把一笔已成功的交易撤销时,使用这个交易.交易名称: commission_cancel_request请求commission_cancel_request1234567890123456116user_id111响应commission_cancel_response000000000243110200704050101010000成功查询交易交易用途:用于查询某一笔交易的状态.交易名称: query_request请求query_request1234567890123456117user_id111响应query_response000000000244112200704050101020000成功6递送成功01234567890123456789010100回执转发交易交易用途:用于将条码转类型或转发到其他的手机.交易名称: er_sendto_request请求er_sendto_request1234567890123456112user_id11113960929199001响应er_sendto_response000000000244113200704050101040000成功回执重发交易交易用途:用于客户因客观原因将条码丢失,重新补发条码.交易名称: er_resend_request请求er_resend_request1234567890123456112user_id111响应er_resend_response000000000244113200704050101040000成功回执去图片交易交易用途:用于客户的手机仅能收取普通短信情况下,平台采用去图片下行.交易名称: er_resend_nopic_request请求er_resend_nopic_request1234567890123456114user_id11113960929199响应er_resend_nopic_response000000000244113200704050101040000成功批次数据同步交易用途:用于通用业务系统和外联系统间的批次信息同步,由平台发起.交易名称: er_batch_info_sync_request请求er_batch_info_sync_request1234567890123456XX机构名1,2,312345678901XXX活动名称start_timeend_time12345678901234567890123456789012serv_descuse_times_limitamt_limitpin_check_flag响应er_batch_info_sync_response200704050101040000成功验证数据同步交易用途:用于通用业务系统和外联系统间对帐后的验证信息同步,由平台发起.交易名称: er_verify_info_sync_request请求er_verify_info_sync_request1234567890123456 SP_SEQ 业务流水号1234567812345678123456789091234567890112345678901234567890amt yyyyMMddHHnnss0响应er_verify_info_sync_response200704050101040000成功数字签名(保留)数字签名主要是防止在传送的过程中被报文被他人恶意篡改.对于有相关要求的业务接入商,采用对xml报文全文进行md5摘要算法.然后使用rsa私钥进行加密,到平台后由对应该机构码的公钥进行验证.要求:1. 业务接入商生成一对rsa公私钥,将公钥提交到通用业务平台2. 对xml报文进行md5摘要算法3. 用rsa私钥对摘要数据加密,形成数字签名,并将数字签名进行base64编码4. 将原文和数字签名分两个元素POST到平台上(xml报文放置于xml元素中,数字签名base64后的数据放置于signature元素中)报文通讯方式采用http或https协议,使用post方法,报文放置于xml元素中.