能力开放平台Word格式.docx

1、总部后续将下发商城后台使用手册并组织培训，请各省提前明确本省业务上下架管理部门和责任人（每省可设全省发布人、审核人各一名+地市发布人、审核人各一名/每地市），同期上报总部。二、 能力开放平台对接为适应电子商务的行业发展趋势，移动商城的产品销售平台将依托能力开放平台构建，一方面商户自有系统可以通过能力开放平台获取和更新商城内部的商户、订单、商品、营销等数据，另一方面商户自有系统通过能力开放平台为商城提供购买资格校验、订单通知接收等服务。目前总部已组织编制完成了能力开放平台接口规范V1.0（详见附件二），以及移动商城商户系统与能力开放平台对接指南（详见附件三），拟定于11月初提供公开测试环境。请试

2、点省公司和终端公司根据年底业务上架需要，结合自身实际情况确定系统接入方案，并于10月25日前提交接入申请，总部审核通过后下发接入所需要的APPKEY等凭据。申请接入通过的省公司可根据本省系统改造进度自行安排测试计划，但应确保11月底前完成，以满足12月入驻演练的需要。未纳入试点范围的省公司应提前学习相关技术文档，做好技术方案储备和系统配套改造工作，具体接入的时间安排总部将另文通知。三、 统一接口平台对接移动商城的自助服务平台将通过统一接口平台、一级BOSS网状网与各省CRM系统互通，完成业务查询、业务办理、充值缴费等业务。根据关于下发的通知（业通 2013 229号）的要求，请6个试点省力争在

3、2013年10月底完成改造具备联调条件，其余省于2013年11月底改造完毕具备联调条件。总部将于11月启动6个试点省的联调测试，12月启动其余25省的联调测试，年底前完成业务上线。四、 其他事项1、请各省公司以及终端公司针对业务上架、能力开放平台对接、统一接口平台对接等三项工作分别指定专门的接口人，并于10月20日前将接口人信息按照附件表格（详见附件四）要求，通过邮件方式发给总部相关联系人。2、根据“总部收单、各省执行”的职责分工原则，移动商城负责接收用户订单并流转至各省公司进行订单处理工作，总部后续将下发商城运营相关规范，请各试点省根据本省实际情况，提前梳理省内订单处理业务流程，并做好运营团

4、队的组建工作。业务需求内容能力开放平台是中国移动网上商城和商户自有系统进行IT对接的一个桥梁。一方面商户自有系统可以通过能力开放平台获取和变更移动商城内部的商户、订单、商品、营销等数据，另一方面商户自有系统通过能力开放平台为商城提供购买资格校验、订单通知接收等服务。图1-1 能力开放平台的位置本规范对能力开放平台与商户自有系统交互接口提出规定，能力开放平台内部和商户自有系统共同使用。术语 全 称说 明APPKEY应用标识用于标识唯一的商户自有系统。SECRET应用秘钥用于应用请求能力开放平台接口参数加密的秘钥。加入能力开放平台在商户开始开发自己的应用之前，需要先创建一个用于调用商城能力开放平台

5、API的应用，能力开放平台会提供应用创建管理的界面，应用创建后会生成appkey和secret秘钥，用于接口请求和签名认证。详细流程见下图：图4-1 加入能力开放平台流程说明：1、 首先需要在移动商城完成入驻手续成为商户。2、 使用商户账户登录能力开放平台web界面系统，填写必要信息后，创建属于自己商户的应用，应用创建后会生成只属于该应用的APPKEY和秘钥SECRET。创建应用时需要商户在能力开放平台web界面系统内完成资格校验接口和通知接口的添加。校验和通知接口用于商城经由能力开放平台请求商户系统，发送订单生成通知、资格校验等请求。3、 应用测试，应用申请成功后即可开始开发测试，此时的应用

6、只有调用测试环境接口的权限。4、 应用上线，测试完成后根据测试报告集团审核通过后可以部署到正式环境上线。授权机制授权流程图5-1 商户请求能力开放平台授权机制过程【流程说明】1、商户向移动商城能力开放平台接口发送请求；2、开放平台服务器对请求IP进行鉴权；3、服务器IP鉴权失败，返回错误信息；4、服务器IP鉴权成功后，接收请求签名参数；5、对接收到的签名参数进行比较验证，并对商户身份进行认证；6、签名认证失败，直接返回错误信息；7、签名认证成功，接收请求报文并响应；8、响应后返回接口请求的应答报文；图5-2 反向校验和通知授权机制过程1、能力开放平台向商户自有系统发送请求；2、商户系统对请求I

7、P进行鉴权；5、对接收到的签名参数进行比较验证；5.1 服务器间鉴权简介与实现能力开放平台和商户自有系统服务器之间采用双向的IP白名单认证，各自系统都要提供服务器IP给对方加入白名单，并在访问时在网络或者程序端进行验证。认证实现在IP认证实现中有两种可选方案：1、 在系统中配置IP分组认证表，IP认证模块根据IP分组中目的地址，端口号等信息，对来往的IP信息进行过滤，允许或者禁止某些IP地址的访问。2、 在服务器端，通过防火墙来进行IP认证的过滤，对不满足的用户IP的请求进行阻止。接口说明订单类接口获取订单列表接口描述：获取订单ID列表功能接口地址：接口提供方：商城能力开放平台请求发起方：商户

8、自有系统接口版本号：1.0调用方式：HTTPS GET应答报文格式：JSON获取单笔订单详情获取订单当前状态信息根据订单ID获取订单当前状态信息。修改订单状态HTTPS POST获取订单状态变更流水信息根据订单ID获取订单的状态变更流水信息码号购买资格校验码号购买资格校验接口商户自有系统提供的资格校验接口新用户合约机购买资格校验老用户合约机购买资格校验订单生成通知用户支付后，通知商户自有系统订单生成商户自有系统提供的通知接收接口订单状态通知撤单通知 商户自有系统上报物流单号上报商品的物流单号获取物流信息根据订单标识查询物流信息获取用户身份证图片添加套餐添加单个套餐接口添加号码添加单个号码接口添加合约添加单个合约接口添加合约档（购机送话费合约档）添加单个合约档（购机送话费合约档）接口添加合约档（充值送购机款+送话费合约档）添加单个合