WABP平台与AP实时接口文档v193

卓望信息技术（北京）有限公司1WABP平台和合作方之间实时接口卓望信息技术（北京）有限公司2文档变更记录序号变更内容说明版本号版本日期执笔人1初稿1.02012-5-9柳长俊2更新接口一参数类型与提供方说明1.12012-5-24柳长俊3更新接口一和接口二参数说明1.22012-7-12柳长俊4增加接口一中xid参数说明1.32012-9-3柳长俊5增加接口二中数字签名参数说明1.42012-12-26赖国健6增加包月订购业务部分1.52012—2-19赖国健7增加确认用户状态接口，更新同步订购关系接口（增加扣费成功参数，合并按次和周期业务同步订购关系接口）1.62013-03-25赖国健8增加AP侧发起退订请求接口1.72013-05-28赖国健9增加挂起和激活；退订接口增加数字签名1.7.12013-06-06赖国健10修改的url访问地址及增加对wap业务域名或IP报备的说明1.7.22013-07-22鄢华健11增加AP侧透传手机号伪码(mid)至WABP页面()显示(同步更新接口一文档结构)1.7.32013-08-05鄢华健12增加与AP交互时，WABP向AP透传手机号伪码、省份等信息（接口二、接口三）1.82013-8-20鄢华健13增加对AP鉴权时serviceId的说明，防止恶意用户进行修改引起的安全问题1.8.12013-10-8鄢华健14增加返回AP的bu链接时，增加wabp侧的参数及响应码1.8.22013-12-4鄢华健15对AP跳转至WABP订购页()增加数字签名验证，防止恶意用户修改url参数1.92014-4-16鄢华健16增加对bu返回合作方url参数的说明1.9.12014-4-23鄢华健171)增加3.4.1.2.业务退订响应消息体返回值说明2)在“2.4.功能描述”增加有关数字签名的说明3)文档中“3.2.1.1.确认用户状态请求消息体”中属性“OrderTYpe”有误，按照实际情况，现调整为“OrderType”4)附录中，增加“5.2.联调环境说明”5)调整订购页URL地址示例6）增加3.4.1.1.业务退订请求消息体中的属性“FeeType”的取值：05长周期1.9.22014-06-20姚德成卓望信息技术（北京）有限公司3181）在章节“3.4.1.1.业务退订请求消息体”中，补充属性“APTransactionID”、“ChannelId”、“APContentId”、“APUserId”的来源说明。2）在章节“3.4.1.1.业务退订请求消息体”中，增加退订说明。3）在章节“3.1.接口一从合作伙伴营销页跳转到wabp订购页URL”中，补充参数“aptid”的备注说明。1.9.32014-07-10姚德成卓望信息技术（北京）有限公司4目录WABP平台和合作方之间实时接口......................................................................................................1文档变更记录..........................................................................................................................................21.概述.....................................................................................................................................................51.1.文档概述..................................................................................................................................51.2.引用标准..................................................................................................................................52.业务简介.............................................................................................................................................52.1.业务定义..................................................................................................................................52.2.业务特征..................................................................................................................................52.3.业务网络结构..........................................................................................................................52.4.功能描述..................................................................................................................................53.总体规范.............................................................................................................................................63.1.接口一从合作伙伴营销页跳转到wabp订购页URL.........................................................63.2.接口二发起发货准备通知接口............................................................................................73.2.1.消息体...........................................................................................................................83.3.接口三通知AP发货...........................................................................................................103.4.接口四AP通知WABP平台退订（只针对时长和包月业务）........................................103.4.1.消息体.........................................................................................................................114.订购类业务接口说明（接口三通知AP发货）............................................................................134.1.按次/包月订购业务订购关系同步接口...............................................................................134.1.1.业务功能.....................................................................................................................134.1.2.业务流程.....................................................................................................................134.1.3.消息体.........................................................................................................................135.附录...................................................................................................................................................175.1.省份说明(id与名称对应关系)..............................................................................................175.2.联调环境说明........................................................................................................................18卓望信息技术（北京）有限公司51.概述1.1.文档概述本文档描述WABP平台和合作方之间的接口规范。1.2.引用标准省略。2.业务简介2.1.业务定义2.2.业务特征2.3.业务网络结构2.4.功能描述1.数字签名：数字签名说明：wabp平台采用DSA算法，要求AP将除sign之外的其它参数，以参数名做自然排序转化成URL参数形式。并按GBK编码转成二进制。然后调用DSA算法对二进制码进行签名。再将签名结果用BASE64编码，并转成字符串，得到sign参数的内容，即签名结果。同时，我们为AP技术工程师提供了Java、php等多种开发语言的参考代码供商户来选择。为了简化开发过程，我们对代码进行了一定程度的封装，一般商户主要关心自己的参数传递和返回。关于数字签名，贵我双方各自生成自已的密钥对（公钥、私钥），私钥自留用于加密，将公钥提供给对方用于解密。在进行数据传输时，数据发送方私钥加密，数据接收方用对方所提供的公钥解密。有关密钥对的变更，需要贵我双方的同时更新才能完成，而且是需要事先约定好时间同时进行方可；并不是说每次消息交互均需要变更密钥对。卓望信息技术（北京）有限公司63.总体规范3.1.接口一从合作伙伴营销页跳转到wabp订购页URL由合作方页面经过固定链接，通过httpGet方式接入到WABP平台，不同计费业务通过url链接中的sin参数区分(wabp平台为合作方开放的一个入口url)。例如：地址：