手机支付系统接口2.0_技术集成文档_代理商资金归集

《手机支付系统接口2.0_技术集成文档_代理商资金归集》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、手机支付系统接口(2.0)代理商资金归集技术集成文档2013年6月修订记录修订日期修订人动作修订说明版本号2013-6-5刘芳Create1.0注：文件中的红色字体仅为说明作用，则实际的说明书中无需引用；填写说明：项目名称、项目编号、项目经理、项目总监按照本项目实际情况填写。文档密级是该文档允许扩散的范围。对于高阳公司，机密文件、秘密文件必须由银行产品事业部经理室批准方可借阅；内部文件经一般授权后可由在公司内部和项目组内部传阅；公开文件不需经过授权，可自由进行阅读。文档主送是指该文档应该主送的对象，项目总监、项目经理是该文档必须主送的对象之一。文档抄送是指该文档应该抄送的对象，项目管理组是该

2、文档应该抄送的对象之一。版本号是指该文档的版本次序号，该文档首次发布时可确定为1.0，如果在上一版的基础上有细微的调整和修改，则可在小数点后次版本号加1；如果该文档内容总体上有重大变化或增加/删除了重要章节，则小数点主版本号加1。目录1引言51.1文档概述51.2业务术语51.3通讯模式51.3.1后台通讯模式51.3.2文件接口模式71.4安全规范81.4.1数字签名81.4.2提交URL92商户接口102.1代理商信息录入102.2代理商信息修改122.3代理商信息删除142.4代理商实时扣款接口162.5代理商扣款结果查询173文件接口203.1批量代扣文件203.2日终对账文件214

3、附录224.1银行代码对照表224.2省代码对应表221引言1.1文档概述阅读对象：各省boss系统的技术开发人员。1.2业务术语1.3通讯模式用https保证通讯链路的安全，用数字签名保证交易不被篡改。将整个串做一次加密保证数据不被窃取。根据交易类型的不同，接口分为两种：后台通讯和文件接口。11.11.21.311.11.21.31.3.11.3.1后台通讯模式后台通讯模式用于不需要用户交互的交易，比如代理商信息维护、实时扣款、扣款记录查询等。各省boss系统根据报文组好数据包后向手机支付系统发起请求，手机支付系统返回结果报文。1.3.21.3.3Ø代理商信息维护--录入、修改、删除各省b

4、oss系统根据报文格式组好数据包后通过后台通讯向手机支付系统发起请求，手机支付系统返回维护结果。Ø代理商实时扣款各省boss系统根据报文格式组好数据包后通过后台通讯向手机支付系统发起请求，手机支付系统返回扣款结果。Ø代理商扣款记录查询各省boss系统根据报文格式组好数据包后通过后台通讯向手机支付系统发起请求，手机支付系统返回查询结果以及记录信息。Ø代理商主动预存后台通知代理商通过手机指令发起主动充值，再充值完成后手机支付系统会后台通知各省boss预留的通知地址。1.1.1文件接口模式代扣文件：各省boss定时生成代扣文件，并上传至手机支付文件服务器，手机支付系统会定期处理代扣文件以及生成回盘

5、文件。对账文件：每天日终手机支付平台会将上一日所有到账明细记录生成对账文件，存放至手机支付文件服务器。1.1安全规范1.11.1.1数字签名为保证数据传输过程中的数据真实性，完整性和不可抵赖，我们需要对数据进行数字签名，在接收签名数据之后迚行签名校验。签名算法分为MD5和RSA。签名机制如下：1.接口的公钥证书和签名字段不参与组成签名原文串。2.待签名原文是请求参数按照接口文档中自上而下的顺序组装成的字符串。没有值的为空。如果提交的参数为param1=value1¶m2=value2&…¶mN=valueN，则待签名原文为：value1value2…valueN。3.手机支付

6、系统返回的中文字段做UrlEncode转码，且是在做签名之前做转码。签名算法：1.MD5。MD5本是一种摘要生成算法，是不能用于签名的。但是，通过在待签名数据之后用过特殊处理加上一串私密内容(指令发送、接收双发事先规定好的，我们称其为商户密钥)，就可以用于签名了。2.RSA。RSA本身是加密解密算法，不能用户数字签名的，但是配合SHA-1数字签名算法后就能实现数字签名的功能。通过对签名值做RSA加密解密，就可以无需使用双方约定的商户密钥，而且减少了密钥泄漏的风险。商户系统发送请求时，使用商户的私钥对签名值进行RSA加密，手机支付系统使用商户的公钥进行校验；手机支付系统返回数据时，使用手机支付

7、的私钥对签名值进行RSA加密，商户使用手机支付的公钥进行校验。1.1.1提交URL各省boss系统提交的地址统一为：https://ipos.10086.cn/ips/yskService1商户接口11.1代理商信息录入请求参数：参数名称参数命名最大长度类型备注可否为空协议参数字符集characterSetMax(2)String只能取以下枚举值00-GBK01-GB231202-UTF-8默认00-GBKY