ISV訂購接口規範

價格策略頁面

[編輯 ] 阿里平臺訂購頁面內嵌頁面時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生成不要寫成硬編碼。