### ASSP平台ISV订购接口规范详解
#### 一、概述
阿里巴巴软件即服务(Alisoft SaaS Platform,简称ASSP)平台旨在为独立软件开发商(ISV, Independent Software Vendor)提供一套标准化的服务接口，以便更好地集成和服务于阿里巴巴的生态系统。本文档主要介绍了ASSP平台ISV订购接口的规范细节，包括不同订购场景下的参数传递方式、数据格式要求以及商业规则等。
#### 二、修订历史
- **2008-6-16**: 版本1.0，由林秀珍创建了初始版本。
- **2008-7-25**: 版本1.1，林秀珍对订购资源跳转URL的参数进行了变更。
- **2008-9-2**: 版本1.2，林秀珍增加了在订购资源跳转URL中加入`appId`参数。
#### 三、价格策略页面
在ASSP平台中，价格策略页面主要用于处理ISV应用的订购流程，包括新订购、续订等操作。这里详细说明了ISV应用在不同订购场景下需要向平台传递的参数信息。
##### 1.1 阿里平台订购页面内嵌页面时POST参数信息
| 参数名称 | 类型 | 必传 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `signature` | String | Y | 签名信息，用于验证数据的完整性 | 5B84046E71C4DC2F60692482831D3BE8 |
| `subscType` | String | Y | 订购类型：<br>- 0: 新订<br>- 1: 未到期续订<br>- 2: 到期续订<br>- 3: 购买资源 | 0 |
| `appId` | String | Y | 订购的软件ID | 5 |
| `appInstanceId` | String | Y | 订购软件的实例ID | 1282fc73-466a-4fd2-b953-0f0cb601ee35 |
| `appEndDate` | Y | 软件服务的截止时间，订单结束时间不能晚于此点 | 2009-12-31 |
| `subscEndDate` | Y | 已有的订购控制记录的结束日期，新订时为空串 | 2008-05-01 |
| `gmtStartDate` | 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 |
##### 1.2 ISV应用新订时POST阿里平台的参数信息
| 参数名称 | 类型 | 必须 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `signature` | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
| `postData` | String | Y | 原样传回的参数 | .%83%11N%A2%BAal%D6%27%A4 |
| `gmtStartDate` | Y | 订单开始时间,原样传回的参数 | 2008-06-06 |
| `gmtEndDate` | Y | 订单结束时间，根据订单开始时间计算 | 2008-09-05 |
| `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元 |
**备注**:
- *商业规则要求：不允许修改订购开始时间；*
- *订单结束时间必须小于等于传入参数`appEndDate`。*
##### 1.3 ISV应用续订时POST阿里平台的参数信息
分为两种情况：
1. **未到期续订**
2. **到期续订**
**1.3.1 未到期续订**
| 参数名称 | 类型 | 必须 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `signature` | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
| `postData` | String | Y | 原样传回的参数 | .%83%11N%A2%BAal%D6%27%A4 |
| `gmtEndDate` | Y | 订单结束时间 | 2009-12-31 |
| `amount` | Number | Y | 订购总金额 | 10.00 |
| `rentAmount` | Number | Y | 订购金额中的月租部分 | 10.00 |
| `resourceAmount` | Number | Y | 订购金额中的资源部分 | 0.00 |
| `description` | String | N | 订单描述，GBK URL编码 | 10元/月*1月=10元 |
**备注**:
- *商业规则要求：不允许修改订购开始时间；*
- *订单结束时间必须小于等于传入参数`appEndDate`；*
- *不允许修改订购控制参数；*
**1.3.2 到期续订**
| 参数名称 | 类型 | 必须 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `signature` | String | Y | 签名信息 | 5B84046E71C4DC2F60692482831D3BE8 |
| `postData` | String | Y | 原样传回的参数 | .%83%11N%A2%BAal%D6%27%A4 |
| 其他参数与未到期续订相同 |
**备注**:
- *商业规则要求：不允许修改订购开始时间；*
- *订单结束时间必须小于等于传入参数`appEndDate`；*
- *不允许修改订购控制参数；*
#### 四、阿里平台通知URL中POST参数信息
这部分内容详细规定了在ISV完成订购流程后，ASSP平台会通过POST请求发送到ISV指定的通知URL中包含的具体参数信息。这些参数包含了用户订购的所有必要信息，以便ISV进行后续的业务处理。
#### 五、商业规则补充
为了确保ASSP平台ISV订购接口能够顺利执行并符合阿里巴巴平台的商业规则，这里列出了一些重要的规则补充：
- 订购开始时间一经设定，不得更改。
- 订单结束时间必须小于等于`appEndDate`。
- 对于续订操作，无论是未到期还是到期续订，订购控制参数均不得修改。
- 所有POST请求中的敏感数据（如金额等）必须经过签名算法加密处理。
#### 六、SIGNATURE参数生成备注
- `SIGNATURE`参数是基于一系列明文参数通过特定的加密算法生成的，用于保证数据传输的安全性和完整性。
- 在实际应用中，ISV需遵循ASSP平台提供的签名算法和规则来生成对应的签名值。
#### 结语
通过上述内容的详细介绍，我们可以了解到ASSP平台ISV订购接口规范的重要性和具体实现细节。这对于ISV来说是非常宝贵的资源，它不仅有助于ISV更好地集成到阿里巴巴的生态系统中，还能够提高服务质量和用户体验。未来，随着技术的发展和市场的需求变化，ASSP平台也会持续优化其接口规范，以满足更多ISV的需求。
