辽宁移动接口统付联调手册v10版

对外资料辽宁移动统付接口联调说明手册编写刘威男编写时间20160128审核审核时间文档版本V10亚信科技版权所有文档中的全部内容属亚信集团所有，未经允许，不可全部或部分发表、复制、使用于任何目的。辽宁移动统付接口联调说明手册文档修订摘要日期版本号修订章节描述作者评审者评审日期20150128V10初稿刘威男辽宁移动统付接口联调说明手册I目录1引言311文档用途312适用范围及阅读对象313术语和缩略语314参考资料315联调配合人员416联调注意事项42网关接入方法421网关接入传输规范4211方式和协议4212编码方式4213开发语言4214调用入口5215网关调用参数说明5216交易报文加密6217交易报文密钥加密6218签名SIGN7219响应参数92110签名SIGN验证102111响应报文秘钥解密122112响应报文解密123交易规范1231接口约定12311报文元素约定124接口参数1641话费统付接口16接口名称16功能描述16输入参数16输出参数1642统付记录明细查询17接口名称17功能描述17输入参数17输出参数1743查询集团成员可选资费18接口名称18功能描述18输入参数18输出参数18辽宁移动统付接口联调说明手册II44统付产品受理接口18接口名称18功能描述18输入参数18输出参数195附录20附录A数据结构20产品属性信息20附录B常见错误分析解决22B1签名错误22B2返回码参数对照及解决方法22辽宁移动统付接口联调说明手册31引言11文档用途本文旨在为第三方合作站点应用访问辽宁移动业务支撑系统开放服务提供的接口调用与交互规范。12适用范围及阅读对象本规范仅适用于由第三方应用服务器端通过发HTTP协议采用POST或GET方式调用接口进行交易的场景。13术语和缩略语API_ID在开发者创建应用后，平台分配的唯一标识一个应用的字符串。API_SECRET在开发者创建应用后，平台分配的应用密钥，用于平台与合作站点之间通信时的加密和参数签名。14参考资料1、辽宁移动业务支撑系统开放平台技术规范V1312、第三方系统统付接口规范V043、第三方系统统付接口规范含流量池统付版辽宁移动统付接口联调说明手册415联调配合人员网关联调接口人员蒋宏楷QQ2811614598业务联调接口人员刘威男电岑电话1594046112016联调注意事项请第三方接入厂商首先加入辽宁移动统付接口联调群群号2147762712网关接入方法21网关接入传输规范211方式和协议采用HTTP协议POST或GET方法，鉴于GET方法对传输的限制以及安全性，建议才用POST方法。212编码方式开放平台采用的UTF8编码，涉及到中文时需要使用URLENCODE编码。213开发语言API接口调用采用HTTPREST风格，只需将所需参数拼装成HTTP请求，即可调用，故支持HTTP协议请求的程序语言，均可调用相应API，例如PHP、C、ASP、JAVA、DELPHI等。辽宁移动统付接口联调说明手册5214调用入口环境地址，即调用接口API时，都通过访问该地址，来获取该接口需要获取的数据正式环境须等到测试环境联调成功之后，由客户经理向省公司业务支撑中心申请正式环境地址。测试环境接口传递参数方法样例HTTP/1067101328080/LEVEL1/V1/TRANSAPP_IDERRORMSG第三方HMAC验证失败/CHECKSIGNFROMOIDBFAILE”签名校验失败分为以下两种情况1SIGN参数生成错误有可能由下列原因引起（1）构造源串时注意URL不包含HOST，如/LEVEL1/V1/TRANS，而不是HTTP/APIXXXCOM/LEVEL1/V1/TRANS；（2）构造源串时，没有将KEY排序后，再将KEYVALUE用拼接起来。（3）构造密钥时，没有将API_SECRET后加“”。（4）某些语言的URLENCODE系统方法在进行URL编码时，并没有按照现行的URL编码规则进行。详见URL编码注意事项。2SIGN参数生成正确，但是参数传输前没有进行URL编码。所有参数传输时都要进行URL编码，包括SIGN。如果没有进行URL编码，则即使SIGN是正确的，但是校验SIGN时不能匹配。B2返回码参数对照及解决方法“CODE“6101“HINT“系统运行发生接口平台未能识别的JAVALANGEXCEPTION异常，错误发生辽宁移动统付接口联调说明手册24原因用户ID0,不是新系统ID,也不是老系统ID。测试环境联系亚信开发人员提供集团编号（CUSTID/GROUPID）。生产环境请跟客户经理确认1客户经理给你的是客户编码（通常为14位）不是集团编码（通常为10位）2客户编码对应的地市，既REGION（和赠送手机号的地市没关系），如沈阳240，每个客户编码唯一对应的3该客户编码是否订购你要赠送的产品对应的策划“CODE“B102“请求报文签名错误（解决方式见文档附录B1）。“CODE“B101“请求报文签名错误（解决方式见文档附录B1）。“CODE“S404“请求报文签名错误（解决方式见文档附录B1）。“CODE“S002“请求报文签名错误（解决方式见文档附录B1）。“CODE“2000“HINT“系统运行发生接口平台未能识别的JAVALANGEXCEPTION异常报文填写错误请根据提示信息检查报文是否没有传入策划编号或者没有填写统付的手机号码。“CODE“9999“HINT“系统运行发生接口平台未能识别的JAVALANGRUNTIMEEXCEPTION异常辽宁移动统付接口联调说明手册25“HINT“系统运行发生接口平台未能识别的JAVALANGEXCEPTION异常通常只发生在测试环境，系统升级中，请稍后20分钟左右再测试，如还有问题，请联系亚信公司人员。“HINT“系统运行发生接口平台未能识别的JAVASQLSQLEXCEPTION异常地市填写错误，测试环境请一律填写报文参数REGION填写240公共信息REGIONCODE填写400“HINT“系统运行发生接口平台未能识别的JAVALANGNUMBERFORMATEXCEPTION异常数字格式错误请注意填写的信息中是否包