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