ISV订购接口规范

1、价格策略页面

阿里平台订购页面内嵌页面时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

3、商业规则补充

以下规则由互联平台系统校验，违反规则的请求将提示异常，请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需要使用控制参数的可以在新订、到期续订、资源购买时改变他们并回传互联平台（若不做修改请原样回传）。

4、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生成不要写成硬编码。