目录

1、从合作伙伴营销页跳转到WABP订购页URL

由合作方页面经过固定链接,通过httpGet方式接入到WABP平台,不同计费业务通过url链接中的sin参数区分(wabp平台为合作方开放的一个入口url)。参数说明:

参数 类型 长度 来源  备注 说明
apco String 20 由合作方提供   合作方内容id
aptid String 20 由合作方提供 BASE64编码 合作方注册用户id伪码
aptrid String 20 由合作方提供   交易流水id
ch String 20 由WABP平台分配   渠道号码
ex String 20 由WABP平台分配   渠道扩展id
sin String 20 由WABP平台分配   业务标识
bu String 2000 由合作方提供 BASE64编码 返回合作方的url(浏览器重定向),
wabp系统会根据成功或失败的情况在跳转该url时动态添加一个参数返回,参数为wabp_result=xxx
000:订购成功,
001:订购失败,
002:cmwap手机号不一致
xid String 10 调取WABP-pac服务器获取 暂时可不填 Pac服务器分配的验证id
mid String 20 由合作方提供 可选 用户手机号码加密,生成规则:数字0-9按从小到大顺序变成RIZBHGECFO,替换完成后在第5个字符后面加KAF。
2、发起发货准备通知接口

2.1、确认用户状态请求消息体


请求方:WABP系统
接收方:合作方系统
业务数据传递确认用户状态请求消息:
消息格式:


     <?xml    version="1.0" encoding="GBK"?>
<VertifyUserState2APReq>
<APTransactionID>交易流水号</APTransactionID>
<APId>企业代码</APId>
<ServiceId>业务代码</ServiceId>
<ServiceType>业务类型</ServiceType>
<ChannelId>渠道代码</ChannelId>
<APContentId>AP内容代码</APContentId >
<APUserId>合作方用户id</ APUserId >
<Msisdn>手机号伪码</Msisdn>
<Province>省份</Province>
<OrderType>订购类型</OrderType>
< Backup1>备用字段1</ Backup1>
< Backup2>备用字段2</ Backup2>
<Actiontime>交易发起时间</Actiontime>
<method>合作方处理方法</method>
<signMethod>签名方法</signMethod>
<sign>签名结果</sign>
</VertifyUserState2APReq >

参数说明

名称 类型 长度 可选 来源 说明
APTransactionID String 50 必需 接口一:aptrid 每次交互的唯一标示
APId String 20 必需 由平台分配 企业代码
ServiceId String 20 必需 由平台分配 业务代码(请鉴权时检查)
ServiceType String 4 必需 由平台分配 业务类型
ChannelId String 8 必需  接口一:ch 渠道代码
APContentId String 16 必需 接口一:apco 内容代码
APUserId String 20 必需 接口一:aptid 合作方用户id
Msisdn String 20 必需 由平台分配 手机号伪码
Province String 8 必需 由平台分配 省份ID (见附录省份说明)
OrderTYpe String 1 必需 由平台分配 新用户订购:0,老用户续订:1。对按次订购业务,该值为0。
Backup1 String 1 可选 由平台分配 备用字段,暂时传null
Backup2 String 1 可选 由平台分配 备用字段,暂时传null
Actiontime String 20 必需 系统时间 交易发起时间(格式为yyyy-mm-dd hh24:mi:ss)
method String 128 必需 由合作方提供 合作方处理方法
signMethod String 10 必需 由平台分配 签名方法
sign String 1024 必需 由平台分配 签名结果。签名过程是:将除signMethod,sign之外的其它参数加入到treeMap中,以key做自然排序。然后将treeMap转化成URL参数形式。并按GBK编码转成二进制。然后调用DSA算法对二进制码进行签名。再将签名结果用BASE64编码,并转成字符串,得到sign参数的内容,即签名结果。

2.2、确认用户状态响应消息体


消息格式


     <?xml    version="1.0" encoding="GBK"?>
<VertifyUserState2APRsp>
<APTransactionID>交易流水号</APTransactionID>
<ResultCode>应答状态码</ ResultCode>
<ResultMSG>说明文字</ResultMSG>
<RspTime>回复时间</ RspTime >
</VertifyUserState2APRsp>

参数说明

名称 类型 长度 可选 说明
TransactionID String 50 必需 每次交互的唯一标示
ResultCode String 3 必需:000 该用户可以订购 001 该用户不可以订购 应答状态码
ResultMSG String 50 必需 说明文字
RspTime String 20 必需 回复时间
3、通知AP发货

该接口在2种情况下使用:
该接口对应流程文档中“WAP页面计费(非托管)类业务时序图”中第17点或“WEB页面计费类业务时序图”中第19点【通知AP发货】。 在用户订购流程中,完成接口二后,平台会通过该接口通知合作方是否发货。该接口此刻为同步订购关系接口,平台将扣费结果通知给合作方,合作方根据报文中的ServiceAction参数值判断是否发货。ServiceAction为0,表示需要发货;ServiceAction为1,表示不发货。订购业务关系双方的消息交互采用httpPost方式接口,WABP平台和合作方服务器之间通讯采用post xml文件方式,请求处理完成后返回xml文件,文件内容采用GBK编码。
对于包月业务,用户要求立即终止当前业务,平台会通过该接口通知合作方停止服务。合作方根据报文中的ServiceAction参数值判断是否立刻终止服务。ServiceAction为2,表示需要立刻终止服务。


3.1、订购关系同步请求消息体


请求方:WABP系统
接收方:合作方系统
业务数据传递同步请求消息: 消息格式


     <?xml    version="1.0" encoding="GBK"?>
<ServiceWebTransfer2APReq>
<APTransactionID>交易流水号</APTransactionID>
<APId>企业代码</APId>
<ServiceId>业务代码</ServiceId>
<ServiceType>业务类型</ServiceType>
<ChannelId>渠道代码</ChannelId>
<APContentId>AP内容代码</APContentId >
<APUserId>合作方用户id</ APUserId >
<Msisdn>手机号伪码</Msisdn>
<Province>省份</Province>
<OrderType>订购类型</OrderType>
< Backup1>备用字段1</ Backup1>
< Backup2>备用字段2</ Backup2>
<Actiontime>交易发起时间</Actiontime>
<ServiceAction>业务处理方式</ServiceAction>
<method>合作方处理方法</method>
<signMethod>签名方法</signMethod>
<sign>签名结果</sign>
</ ServiceWebTransfer2APReq >

名称 类型 长度 可选 来源 说明
APTransactionID String 50 必需 接口一:aptrid 每次交互的唯一标示
APId String 20 必需 由平台分配 企业代码
ServiceId String 20 必需 由平台分配 业务代码
ServiceType String 4 必需 由平台分配 业务类型
ChannelId String 8 必需  接口一:ch 渠道代码
APContentId String 16 必需 接口一:apco 内容代码
APUserId String 20 必需 接口一:aptid 合作方用户id
Msisdn String 20 必需 由平台分配 手机号伪码
Province String 8 必需 由平台分配 省份ID(见附录省份说明)
OrderTYpe String 1 必需 由平台分配 新用户订购:0,老用户续订:1。对按次订购业务,该值为0。
Backup1 String 1 可选 由平台分配 备用字段,暂时传null
Backup2 String 1 可选 由平台分配 备用字段,暂时传null
Actiontime String 20 必需 系统时间 交易发起时间(格式为yyyy-mm-dd hh24:mi:ss)
ServiceAction String 4 必需 由平台提供 处理方式。
0:发货;
1:不发货;
2:终止服务;
3:用户主动退订;
4:挂起(包月有效);
5:激活(包月有效);
由于目前boss通知时,未携带退订方式相关参数,因此3:用户主动退订,目前无法区分,暂时统一传2:终止服务。
method String 128 必需 由合作方提供 合作方处理方法
signMethod String 10 必需 由平台分配 签名方法:
sign String 1024 必需 由平台分配 签名结果。签名过程是:将除signMethod,sign之外的其它参数加入到treeMap中,以key做自然排序。然后将treeMap转化成URL参数形式。并按GBK编码转成二进制。然后调用DSA算法对二进制码进行签名。再将签名结果用BASE64编码,并转成字符串,得到sign参数的内容,即签名结果。

3.2、订购关系同步响应消息体


消息格式


     <?xml    version="1.0" encoding="GBK"?>
< ServiceWebTransfer2APRsp>
<APTransactionID>交易流水号</APTransactionID>
<ResultCode>应答状态码</ ResultCode>
<ResultMSG>说明文字</ResultMSG>
<RspTime>回复时间</ RspTime >
</ServiceWebTransfer2APRsp>

参数说明

名称 类型 长度 可选 说明
TransactionID String 50 必需 每次交互的唯一标示
ResultCode String 3 必需:000 成功 001 失败 应答状态码
ResultMSG String 50 必需 说明文字
RspTime String 20 必需 回复时间