价格策略页面
[编辑 ] 阿里平台订购页面内嵌页面时post参数信息
- 表1:
参数名称 | 类型 | 必传 | 说明 | 示例 |
signature | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
subscType | String | Y | 订购类型:0‐新订;1‐未到期续订;2‐到期续订;3‐购买资源 | 0 |
appId | String | Y | 订购的软件ID | 5 |
appInstanceId | String | Y | 订购软件的实例ID,表示一个用户和软件的订购关系 | USER8814CE54937214B4A10CE3F84A2E5137 |
appEnd | Date | Y | 软件服务的截止时间,订单结束时间不能晚于该时点 | 2009‐12‐31 |
subscEnd | Date | Y | 已有的订购控制记录的结束日期,新订时为空串 | 2008‐05‐01 |
gmtStart | Date | Y | 订单开始时间,订单开始时间不能早于该时点 | 2009‐01‐01 |
ctrlParams | String | Y | 已有的订购控制参数,新订时为空串,GBK URL编码 | a=1&b=2 |
returnUrl | String | Y | 指示价格策略页面将输出参数提交到该URL | http://mall.alisoft.com/apps/subsc/ ... |
postData | String | Y | 要求价格策略页面原样传回的参数 | .%83%11N%A2%BAal%D6%27%A4... |
tribeId | String | N
(群服务型应用必传) |
订购的旺旺群号 | 4192996 |
isvOrderId | String | N | 购买资源时回传ISV的外部订单号 | 2009A212 |
[编辑 ] ISV应用新订时post阿里平台的参数信息
- 表2:
参数名称 | 类型 | 必传 | 说明 | 示例 |
signature | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
postData | String | Y | 原样传回的参数 | .%83%11N%A2%BAal%D6%27%A4... |
gmtStart | Date | Y | 订单开始时间, 原样传回的参数 | 2008-06-06 |
gmtEnd | Date | Y(与duration二选一) | 订单结束时间,根据订单开始时间计算 | 2008-09-05 |
duration | Number | Y(与gmtEnd二选一) | 订单订购自然月数 | 1 |
ctrlParams | String | N | 变更后的订购控制参数,若不做改动原样传回,GBK URL编码 | account=1 |
amount | Number | Y | 订购总金额 | 40.00 |
rentAmount | Number | Y | 订购金额中的月租部分 | 30.00 |
resourceAmount | Number | Y | 订购金额中的资源部分 | 10.00 |
description | String | N | 订单描述,GBK URL编码 | 10元/月*3月+ 10元/账号*1个=40元 |
备注: *商业规则要求:不允许修改订购开始时间; *订单结束时间必须小于等于传入参数appEnd。
[编辑 ] ISV应用续订时post阿里平台的参数信息
[编辑 ] 未到期续订
- 表3:
参数名称 | 类型 | 必传 | 说明 | 示例 |
signature | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
postData | String | Y | 原样传回的参数 | .%83%11N%A2%BAal%D6%27%A4... |
gmtEnd | Date | Y(与duration二选一) | 订单结束时间 | 2009-12-31 |
duration | Number | Y(与gmtEnd二选一) | 订单订购自然月数 | 1 |
amount | Number | Y | 订购总金额 | 10.00 |
rentAmount | Number | Y | 订购金额中的月租部分 | 10.00 |
resourceAmount | Number | Y | 订购金额中的资源部分 | 0.00 |
description | String | N | 订单描述,GBK URL编码 | 10元/月*1月=10元 |
备注: * 商业规则要求:不允许修改订购开始时间;* 订单结束时间必须小于等于传入参数appEnd; * 不允许修改订购控制参数;
[编辑 ] 到期续订
- 表4:
参数名称 | 类型 | 必传 | 说明 | 示例 |
signature | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
postData | String | Y | 原样传回的参数 | .%83%11N%A2%BAal%D6%27%A4... |
gmtStart | Date | Y | 订单开始时间 | 2009-01-01 |
gmtEnd | Date | Y(与duration二选一) | 订单结束时间 | 2009-01-31 |
duration | Number | Y(与gmtEnd二选一) | 订单订购自然月数 | 1 |
ctrlParams | String | N | 变更后的订购控制参数,若不做改动原样传回,GBK URL编码 | a=1&b=2 |
amount | Number | Y | 订购总金额 | 10.00 |
rentAmount | Number | Y | 订购金额中的月租部分 | 10.00 |
resourceAmount | Number | Y | 订购金额中的资源部分 | 0.80 |
description | String | N | 订单描述,GBK URL编码 | 10元/月*1月=10元 |
备注: *商业规则要求:不允许修改订购开始时间; * 订单结束时间必须小于等于传入参数appEnd; * 允许修改订购控制参数;
[编辑 ] ISV应用订购资源时跳转阿里平台的URL
ISV应用触发资源订购时跳转平台的URL为:
http://mall.alisoft.com/apps/subsc/subscDisplay!execute.jspa?appId=2 &appInstanceId=USER8814CE54937214B4A10CE3F84A2E5137&subscType=3 &isvOrderId=2009A212
- 参数信息:
参数名称 | 类型 | 必传 | 说明 | 示例 |
appId | String | Y | 订购软件ID | 2 |
appInstanceId | String | Y | 软件实例ID | USER8814CE54937214B4A10CE3F84A2E5137 |
subscType | String | Y | 订购类型,这里必须传值为3表示订购资源,其他值或不传则视为订购或免费开通 | 3 |
isvOrderId | String | N | 外部订单号,在加载自定义价格页面时会回传Post给ISV,后续还会保存到互联平台 | 2009A212 |
[编辑 ] ISV应用订购资源时post阿里平台的参数信息
- 表5:
参数名称 | 类型 | 必传 | 说明 | 示例 |
signature | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
postData | String | Y | 原样传回的参数 | .%83%11N%A2%BAal%D6%27%A4... |
ctrlParams | String | N | 变更后的订购控制参数,若不做改动原样传回,GBK URL编码 | a=1&b=2 |
amount | Number | Y | 订购总金额 | 10.00 |
rentAmount | Number | Y | 订购金额中的月租部分 | 0.00 |
resourceAmount | Number | Y | 订购金额中的资源部分 | 10.00 |
description | String | N | 订单描述,在具体付款时会显示,GBK URL编码 | 1元/分钟* 10分钟 = 10元 |
备注:不允许修改与月租相关的订购控制参数。
[编辑 ] ISV应用订购资源直接Post请求阿里平台付款URL (即合并1.4+1.5为一步)
ISV应用资源订购后Post平台的URL为:
http://mall.alisoft.com/apps/subsc/subscSummary.jspa
- 新表5:
参数名称 | 类型 | 必传 | 说明 | 示例 |
signature | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
ctrlParams | String | N | 变更后的订购控制参数,若不做改动原样传回,GBK URL编码 | a=1&b=2 |
amount | Number | Y | 订购总金额 | 10.00 |
rentAmount | Number | Y | 订购金额中的月租部分 | 0.00 |
resourceAmount | Number | Y | 订购金额中的资源部分 | 10.00 |
description | String | N | 订单描述,在具体付款时会显示,GBK URL编码 | 1元/分钟* 10分钟 = 10元 |
appId | String | Y | 订购软件ID | 2 |
appInstanceId | String | Y | 软件实例ID | USER8814CE54937214B4A10CE3F84A2E5137 |
subscType | String | Y | 订购类型,这里必须传值为3表示订购资源,其他值或不传则视为订购或免费开通 | 3 |
isvOrderId | String | N | 外部订单号,保存到互联平台 | 2009A212 |
备注:不允许修改与月租相关的订购控制参数。
[编辑 ] 2、阿里平台通知URL中post参数信息
- 表6:
参数名称 | 类型 | 必传 | 说明 | 示例 |
signature | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
event | String | Y | 事件类型:subsc-新订;renewAhead-未到期续订;renew-到期续订;resource-购买资源;break-退订 | subsc |
appId | String | Y | 软件ID | 5 |
appInstanceId | String | Y | 软件实例ID | 1282fc73-466a-4fd2-b953-0f0cb601 |
userId | String | Y | 用户ID | 1234 |
如果事件(新订、续订、购买资源)产生新订单,则额外传递以下参数,退订只传上面参数。
subscId | String | Y | 订单ID | 1234 |
gmtStart | Date | Y | 订单开始时间 | 2009-01-01 |
gmtEnd | Date | Y | 订单结束时间 | 2009-01-31 |
ctrlParams | String | Y | 价格策略页面传给AEP的ctrlParams,GBK URL编码 | a=1&b=2 |
totalAmount | Number | Y | 订单总金额 | 40.00 |
amount | Number | Y | 实付金额 | 30.00 |
rentAmount | Number | Y | 实付金额中的月租部分 | 10.00 |
resourceAmount | Number | Y | 实付金额中的资源部分 | 30.00 |
couponAmount | Number | Y | 使用红包金额,这期可不处理红包 | 10.0 |
tribeId | String | N | 旺旺群号 | 4192996 |
isvOrderId | String | N | 外部订单号 | 2009A212 |
[编辑 ] 商业规则补充
- 以下规则由互联平台系统校验,违反规则的请求将提示异常,请isv自觉遵守,以免影响用户体验,具体如
下:
- 处于系统禁止状态的ISV及其应用不能被订购;
- 订购时长应当控制为n个自然月,如2008-01-03~2008-03-02;
- 金额格式小数点后2位有效,最大不能超过99999.99,金额单位为元;
- 订购超过服务截止日期,或者有效期离服务结束期不足1个月的不能订购;
- 订购结束时间不能晚于前一次的结束时间;
- 不能超前订购,即开始时间为订购当天;
- 建议ISV用户获得平台post的订购开始时间gmtStart后,计算出服务截止日期 gmtEnd,然后将gmtStart和
gmtEnd传回,在新订、到期续订和未到期续订中,平台都将服务开始时间gmtStart传给ISV,ISV不用另外处理服务开始时间。 ctrlParams可用来记录ISV应用的控制参数信息,以及资源参数,isv需要使用控制参数的可以在新订、到期续订、资源购买时改变他们并回传互联 平台(若不做修改请原样回传)。
[编辑 ] signature参数生成备注
生成规则:
- 首先,是包含post过来的所有参数,除signature自身外。
- 其次,将这些参数安字母先后顺序进行排序,并带上参数值。
- 最后,将排好的字符串,前面拼上CERT CODE进行md5加密。
其中CERT CODE为ISV软件注册时获得的唯一安全编号。
形式如:Signature=md5(CERT CODE+[param1+value1…paramn+valuen]),参数按字母顺序排列。
我们通过以下方式完成签名制作:
A、将接口方法参数值对根据参数名称的字母排列连接:
Company+alisoft+count+10+isdeleted+false
B、加入CERT CODE获得最后的签名前的字符串:(此处假设CERT CODE为a312)
signature=MD5(a312companyalisoftcount10isdeletedfalse)后字母转大写
注意:以上接口参数每次发布后,可能会有所变动,所以建议signature生成不要写成硬编码。