## 产品特色
**营销工具包** 为AI商户打造一站式营销解决方案。

优惠 支持「百分比折扣」和「固定金额减免」两种模式，并可设置折扣持续时间、特定人群方案，覆盖首购优惠、长期会员折扣、教育优惠等多元营销场景。此外，支付宝提供「先体验后付费」的订阅模式。

| **营销策略** | **场景案例** |
| :---: | :---: |
| 用户拉新 | 5元试用7天，后续订阅48元/月。 |
| 老客留存 | 连续按月订阅享受8折优惠 |
| 人群优惠 | 通过学生认证后，享受5折优惠 |


以下图片仅做线上样式参考，实际页面内容以线上为准。

![](https://mdn.alipayobjects.com/afts/img/A*XB47SrjdmcAAAAAAXhAAAAgAeq8wAA/original?bz=openpt_doc&t=6R-v-QIpn-RChbjp0xY6NL5pvYdV7_cSQLsI3cSOgK4DAAAAZAAAMK8AAAAA)

## 试用期订阅
试用期 为用户提供「先体验后付费」的订阅模式，支持免费试用。试用结束后，系统自动按原价续费，用户感知平滑，无需重新订阅，帮助 AI 商户快速获客并提升转化率。

| **场景** | **典型策略** |
| :---: | :---: |
| 新用户体验 | 提供3天免费试用，降低首购决策门槛 |
| 新产品体验 | 针对特定项目设置试用，引导用户体验新产品 |


+ 试用期时长：仅传入天数，建议试用期设置在3-7天。
+ 试用期金额：支持灵活设定

以下图片仅做线上样式参考，实际页面内容以线上为准。

![](https://mdn.alipayobjects.com/afts/img/A*OTUDQ47RodAAAAAATpAAAAgAeq8wAA/original?bz=openpt_doc&t=VDLBpWqjyWI_-_GonHcDM0bYj13IaA-GsTBgeZzqigsDAAAAZAAAMK8AAAAA)

### 创建试用期
在[alipay.trade.subscription.create（订阅创建接口）](https://opendocs.alipay.com/solution/7a8012f1_alipay.trade.subscription.create.md) 接口下，支持试用期的核心参数：

+ **trial_period_days**：试用期天数
+ **trial_desc**：试用期描述

商家通过** trial_period_days **设置试用期天数，通过** pay_amount **控制试用期价格：若试用期无需支付（即免费试用），则 **pay_amount** 无需进行传参；若需付费试用，传入大于 0 的金额。试用期结束后，系统自动按照 **price_id** 配置的周期价格进行续费扣款。

**完整参数说明**

| **参数** | **名称** | **参数类型** | **是否必填** | **最大长度** | **示例值** | **描述** |
| --- | --- | --- | :--- | :--- | :--- | :--- |
| items | 订阅项目信息 | Array | 是 | - | - | 订阅项目信息列表 |
| ┗ price_id | 价格 id | String | 是 | [1,32] | 202603201234567889 | 价格创建接口（alipay.trade.price.create）返回的价格id，代表本次操作的目标价格信息 |
| customer_id | 支付宝客户 id | String | 是 | [1,64] | 208812345678 | 客户id，客户创建接口（alipay.trade.customer.create）返回的客户id |
| trial_period_days | 试用期天数 | Number | 否 | [1,360] | 7 | 试用期天数：试用期天数设置为正整数，通常建议试用期天数3-7天 |
| trial_desc | 试用期描述 | String | 否 | [1,256] | 免费试用7天 | 用于签约页展示，若不传该字段，则展示默认文案。 低价试用场景文案："{pay_amount}元试用{trial_period_days}天"；免费试用场景文案："免费试用{trial_period_days}天 |
| metadata | 订阅信息元数据 | String | 否 | [1,2000] | {"key":"value"} | 商户自定义元数据，将在全链路通知中返回 |
| pay_amount | 支付金额 | Number | 否 | [1,1000000000] | 100 | 支付金额，单位分； 仅用于商户自定义金额，若传了该值，用户实际支付金额会以该值为准 |


**请求示例（带试用期）**

```json
curl 'https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.subscription.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'app_auth_token=${app_auth_token}' \
 -F 'biz_content={
  "items":[
   {
    "price_id":"202603201234567889"
   }
  ],
  "customer_id":"208812345678",
  "trial_period_days":7,
  "trial_desc":"新用户 7 天免费试用",
  "metadata":"{\"channel\":\"app_store\"}"
}'
```

**响应参数说明**

| **参数** | **名称** | **参数类型** | **描述** |
| :--- | :--- | :--- | :--- |
| **subscription_id** | **订阅 id** | String | 创建的订阅 ID |
| **order_no** | **订阅支付单 ID** | String | 订阅支付单号 |
| **trial_start** | **试用期开始时间** | String | 试用期开始时间，格式：yyyy-MM-dd HH:mm:ss |
| **trial_end** | **试用期结束时间** | String | 试用期结束时间，格式：yyyy-MM-dd HH:mm:ss |
| **alipay_jump_schema** | **支付宝长链跳端 schema** | String | 长链，适用于跳转拉起支付宝客户端 |
| **alipay_schema** | **支付宝跳转的 schema** | String | 短链，适用于生成二维码 |
| **pay_amount** | **支付金额** | Number | 实际支付金额，单位：分（试用期通常为 0） |


**响应示例**

```json
{
    "alipay_trade_subscription_create_response": {
        "code": "10000",
        "msg": "Success",
        "subscription_id": "SUB20260522002",
        "order_no": "2026052219600065896",
        "trial_start": "2026-05-22 10:00:00",
        "trial_end": "2026-05-29 10:00:00",
        "pay_amount": 0,
        "alipay_jump_schema": "https://render.alipay.com/p/XXXXXXXXXX",
        "alipay_schema": "https://qr.alipay.com/XXXXXXXXXX"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}
```

**试用期说明**

| **项目** | **说明** |
| :---: | :---: |
| 试用期时长 | 推荐 3-7 天，商户可自定义 |
| 试用期费用 | 0 元，用户无需付费 |
| 自动续费 | 试用期结束后，系统自动按原价续费 |
| 取消政策 | 用户可在试用期内随时取消订阅，不产生费用 |
| 通知时机 | 试用开始、试用结束、续费成功均会发送通知 |


### 试用期扣款策略
试用期期间扣款默认逻辑如下：

+ 扣款预通知：在试用期到期的前1天，支付宝会向用户发送扣款预通知，提醒用户即将扣款；
+ 执行扣款：在试用期到期的当天，支付宝会对用户进行扣款；
+ 扣款重试：在试用期到期前，支付宝会持续根据算法进行多次扣款，直到扣款成功；
+ 扣款失败：若试用期已到期仍未扣款成功，支付宝将不再进行扣款，并解约订阅产品。

### 查询试用期
商家可调用[alipay.trade.subscription.query（订阅查询接口）](https://opendocs.alipay.com/solution/d6b6c14f_alipay.trade.subscription.query.md)查询试用期的状态和信息。

**重要参数说明**

| **参数** | **名称** | **参数类型** | **是否必填** | **最大长度** | **示例值** | **描述** |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| **subscription_id** | **订阅 id** | String | 是 | [1,64] | 2026050800300499484 | 订阅 ID |
| **customer_id** | **支付宝客户 id** | String | 是 | [1,64] | 202605080030600439037 | 支付宝客户 ID |


**请求示例**

```json
curl 'https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.subscription.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'app_auth_token=${app_auth_token}' \
 -F 'biz_content={
  "subscription_id":"2026050800300499484",
  "customer_id":"202605080030600439037"
}'
```

**响应参数说明（试用期相关）**

| **参数** | **名称** | **参数类型** | **描述** |
| :--- | :--- | :--- | :--- |
| **trial_start** | **试用期开始时间** | String | 试用期开始时间 |
| **trial_end** | **试用期结束时间** | String | 试用期结束时间 |


**响应示例（试用期信息）**

```json
{
    "alipay_trade_subscription_query_response": {
        "msg": "Success",
        "subscriptions": [
            {
                "subscription_id": "2026050800300499484",
                "subscribe_title": "试用测试",
                "created": "2026-05-08 10:43:31",
                "subscription_status": "TRIALING",
                "trial_start": "2026-05-08 10:43:31",
                "trial_end": "2026-06-07 23:59:59",
                "current_period_end": "2026-06-07 23:59:59",
                "customer_id": "202605080030600439037",
                "items": [
                    {
                        "quantity": 1,
                        "item_id": "2026050800300546321",
                        "created": "2026-05-08 10:43:31",
                        "price": {
                            "gmt_create": "2026-05-08 10:43:27",
                            "product": {
                                "gmt_create": "2026-05-08 10:43:27",
                                "metadata": "{\"level\":\"annual\",\"category\":\"membership\"}",
                                "name": "年度会员服务",
                                "description": "年度会员订阅服务",
                                "active": true,
                                "id": "202605080010000151803"
                            },
                            "metadata": "{\"promotion\":\"new_year_discount\"}",
                            "recurring": {
                                "interval_count": 1,
                                "usage_type": "licensed",
                                "interval": "MONTH"
                            },
                            "product_id": "202605080010000151803",
                            "active": true,
                            "id": "202605080020000166958",
                            "unit_amount": "1",
                            "type": "recurring"
                        }
                    }
                ],
                "current_period_start": "2026-05-08 10:43:31",
                "start_date": "2026-05-08 10:43:31"
            }
        ],
        "code": "10000"
    },
    "sign": "kYtrT6y/bnv5JfbRlhsaWaZPirazVKUDOuCH2GhYxps3hVi9GnZ9Rnu9g2gzydGXHhUZGPl8Sg/dUegtgOywJ5vilvFY1JLYVW/fLHaykhGpxWF3QqWrlrsWeRACYjXqyqzD+88l9Mjsn2aFGcXbZkwUohIwgeFBzmY2Qv8qDgo4lh79Qa7PehHQgrHcNy88mVo8MbMncGa+wLku5ZbEISd6dMQzW+Dcf7BCqfEum5A9U7dYEZsGsJW1gImNxX3iTff1bCS34wbcCfuecxxRTCOFInqOnWHtKzKh6qgzO05QPL6BUR2YI4E6zZ6CSOX9U2OUv4waVWbbCVLyMdXjpA=="
}
```

## 优惠
优惠 为AI商户提供灵活的折扣策略，支持百分比折扣和固定金额减免，并可设置折扣持续时间，满足从首购优惠到长期会员折扣的各种营销需求。

优惠可配置两种折扣类型：

| **类型** | **说明** | **适用场景** |
| :--- | :--- | :--- |
| percent_off | 百分比折扣 | 8 折优惠、9 折优惠等 |
| amount_off | 固定金额折扣 | 满 100 减 20、立减 5 元等 |


优惠可配置三种持续时间：

| **类型** | **说明** | **适用场景** |
| :--- | :--- | :--- |
| once | 仅使用一次 | 首购优惠、一次性折扣 |
| repeating | 前X个周期有效 | 新用户前 3 个周期享 5 折 |
| forever | 永久有效 | 高级会员终身享 9 折 |


### 创建优惠
商家可调用 [alipay.trade.promotion.coupon.create（订阅营销优惠创建接口）](https://opendocs.alipay.com/solution/a6ea4c48_alipay.trade.promotion.coupon.create.md)创建灵活的折扣策略，支持百分比折扣和固定金额减免，并可设置折扣持续时间。

**注意：**

+ 优惠创建时需要指定折扣类型：百分比折扣（percent_off）或固定金额折扣（amount_off）
+ 支持设置优惠的有效期（redeem_by）

**重要参数说明**

| **参数** | **名称** | **参数类型** | **是否必填** | **最大长度** | **示例值** | **描述** |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| **name** | **优惠名称** | String | 是 | [1,64] | 新客 5 折优惠 | 优惠名称，用于展示 |
| **percent_off** | **百分比折扣** | Number | 条件必填 | [1,100] | 10 | 百分比折扣，单位：百分比，例如 10 表示 10% OFF。与 amount_off 二选一 |
| **amount_off** | **固定折扣金额** | Number | 条件必填 | [1,1000000000] | 2000 | 固定折扣金额，单位：分。与 percent_off 二选一 |
| **duration** | **持续时间类型** | String | 是 | [1,32] | once | 持续时间类型：once(仅一次)、repeating(前 X 周期)、forever(永久) |
| **duration_in_iterations** | **持续周期数** | Number | 否 | [1,1000] | 3 | 当 duration_type 为 repeating 时必填，表示前 3 个周期有效 |
| **redeem_by** | **优惠过期时间** | String | 否 | [1,32] | 2026-12-31T23:59:59Z | 优惠领取截止时间，过期后新订阅不可用 |
| **metadata** | **优惠元数据** | String | 否 | [1,2000] | {"key":"value"} | 商户自定义元数据 |


**请求示例**

```json
curl 'https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.promotion.coupon.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'app_auth_token=${app_auth_token}' \
 -F 'biz_content={
 "request_info":{
 "duration":"repeating",
 "redeem_by":"2026-02-20 14:10:00",
 "coupon_id":"5JXR5XXW",
 "name":"新用户10元立减",
 "percent_off":10,
 "amount_off":1000,
 "duration_in_iterations":"3"
 }
}' 
```

**响应参数说明**

| **参数** | **名称** | **参数类型** | **描述** |
| :--- | :--- | :--- | :--- |
| **coupon_id** | **优惠 id** | String | 创建的优惠 ID |
| **name** | **优惠名称** | String | 优惠名称 |
| **percent_off** | **百分比折扣** | Number | 百分比折扣，单位：百分比 |
| **amount_off** | **固定折扣金额** | Number | 固定折扣金额，单位：分 |
| **duration** | **持续时间类型** | String | once/repeating/forever |
| **duration_in_iterations** | **持续周期数** | Number | 持续周期数 |
| **redeem_by** | **优惠过期时间** | String | 领取截止时间 |
| **active** | **是否可用** | Boolean | 优惠是否可用 |
| **created** | **创建时间** | String | 创建时间 |


**响应示例**

```json
{
 "alipay_trade_promotion_coupon_create_response":{
 "code":"10000",
 "msg":"Success",
 "coupon_info":{
 "coupon_id":"5JXR5XXW",
 "name":"新用户10元立减",
 "amount_off":1000,
 "percent_off":10,
 "duration":"repeating",
 "duration_in_iterations":"3",
 "redeem_by":"2026-02-20 14:10:00"
 }
 },
 "sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}
```

### 使用优惠
优惠可以在用户订阅购买和升级时使用。**注意：**优惠仅适用于「个人订阅」。

订阅创建时，可通过调用[alipay.trade.subscription.create（订阅创建接口）](https://opendocs.alipay.com/solution/7a8012f1_alipay.trade.subscription.create.md)使用优惠

**重要参数说明**

| **参数** | **名称** | **参数类型** | **是否必填** | **示例值** | **描述** |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **items** | **订阅项目信息** | String | 是 |  | 用于记录核心的订阅项目信息 |
| **┗ price_id** | **价格id** | String | 是 | 202603201234567889 | 价格创建接口（alipay.trade.price.create）返回的价格id，代表本次操作的目标价格信息 |
| **┗ coupon_id** | **优惠id** | String | 否 | 9WJ36SEC | 营销创建接口（alipay.trade.promotion.coupon.create）返回的优惠id，升级时可使用优惠券抵扣 |
| **customer_id** | **客户id** | String | 是 | 208812345678 | 客户id，客户创建接口（alipay.trade.customer.create）返回的客户id |
| **metadata** | **订阅信息元数据** | String | 否 | {"key":"value"} | 商户可通过此字段进行订阅信息的自定义传参，订阅生效后不可修改，将在全链路通知或查询中返回 |
| **pay_amount** | **支付金额** | String | 否 | 100 | 支付金额，单位分；仅用于商户自定义金额，若传了该值，用户实际支付金额会以该值为准；若不传该金额，则会按照传入的价格id来获取本次应支付的金额 |


注意：其它参数若有传参需要，请与支付宝技术支持沟通确认

**请求示例**

```json
curl 'https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.subscription.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'app_auth_token=${app_auth_token}' \
 -F 'biz_content={
    "customer_id": "202603291031500001001",
    "items": [
        {
            "price_id": "202604130020000046658",
            "coupon_id": "5JXR5XXE"
        }
    ]
}'
```

---

**响应示例**

```json
{
    "alipay_trade_subscription_create_response": {
        "order_no": "2026052210001802785",
        "subscription_id": "2026052200001052354",
        "msg": "Success",
        "code": "10000",
        "alipay_schema": "https://u.alipay.cn/xxxxxx",
        "pay_amount": 4,
        "promotion_info": "[{\"couponId\":\"5JXR5XXE\",\"discountAmount\":0,\"originAmount\":4,\"percentOff\":\"10\"}]",
        "alipay_jump_schema": "alipays://platformapi/startApp?xxxxxxxxxx"
    },
    "sign": "xxxxxxOWg=="
}
```

订阅升级时，可通过调用[alipay.trade.subscription.modify（订阅修改接口）](https://opendocs.alipay.com/solution/6cd02c10_alipay.trade.subscription.modify.md)使用优惠

**订阅升级参数说明**

| **参数** | **名称** | **参数类型** | **是否必填** | **最大长度** | **示例值** | **描述** |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| **subscription_id** | **订阅id** | String | 是 | [1,64] | 20260320123156789 | 需要升级的订阅id |
| **modify_type** | **更新类型** | String | 否 | [1,64] | UPGRADE | 固定设置为 `UPGRADE`，表示订阅升级操作。如不传默认为UPGRADE |
| **preserve_billing_cycle** | **是否保持计费周期不变** | Boolean | 否 | - | true | 是否保持计费周期不变。`true` - 保持原周期，升级后按原周期计算差价；`false` - 重置周期，升级后按完整新周期计算 |
| **pay_amount** | **支付金额** | Number | 否 | [0,1000000000] | 100 | 升级支付金额，单位：分。用于商户自定义升级费用，如不传则系统自动计算升级差价 |
| **items** | **订阅项目信息** | Array | 否 | [0,100] | - | 升级后的订阅项目信息 |
| **┗ item_id** | **订阅项id** | String | 否 | - | 2026032012314 | 订阅项id |
| **┗ price_id** | **价格id** | String | 否 | - | 202603201234567889 | 价格创建接口（alipay.trade.price.create）返回的价格id，代表本次操作的目标价格信息 |
| **┗ coupon_id** | **优惠id** | String | 否 | - | 9WJ36SEC | 营销创建接口（alipay.trade.promotion.coupon.create）返回的优惠id，升级时可使用优惠券抵扣 |


注意：其它参数若有传参需要，请与支付宝技术支持沟通确认

**升级请求示例**

```json
curl 'https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.subscription.modify&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'app_auth_token=${app_auth_token}' \
 -F 'biz_content={
 "subscription_id":"20260320123156789",
 "modify_type":"UPGRADE",
 "preserve_billing_cycle":true,
 "pay_amount":100,
 "items":[
  {
   "item_id":"2026032012314",
   "price_id":"202603201234567889",
   "coupon_id":"9WJ36SEC"
  }
 ]
}'
```

---

**响应示例**

```json
{
    "alipay_trade_subscription_create_response": {
        "order_no": "2026052210001802785",
        "subscription_id": "2026052200001052354",
        "msg": "Success",
        "code": "10000",
        "alipay_schema": "https://u.alipay.cn/xxxxxx",
        "pay_amount": 4,
        "promotion_info": "[{\"couponId\":\"5JXR5XXE\",\"discountAmount\":0,\"originAmount\":4,\"percentOff\":\"10\"}]",
        "alipay_jump_schema": "alipays://platformapi/startApp?xxxxxxxxxx"
    },
    "sign": "xxxxxxOWg=="
}
```

### 查询优惠
商家可调用[alipay.trade.promotion.coupon.query（订阅营销券查询接口）](https://opendocs.alipay.com/solution/4bae3c76_alipay.trade.promotion.coupon.query.md)查询已创建的优惠信息。

**重要参数说明**

| **参数** | **名称** | **参数类型** | **是否必填** | **最大长度** | **示例值** | **描述** |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| **coupon_id** | **优惠 id** | String | 否 | [1,64] | Z83YJJAR | 优惠 ID，不传时返回所有优惠列表 |


**请求示例（查询单个优惠）**

```json
curl 'https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.promotion.coupon.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'app_auth_token=${app_auth_token}' \
 -F 'biz_content={
 "coupon_id":"29XGG87G"
}' 
```

**请求示例（查询所有优惠）**

```json
curl 'https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.coupon.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'app_auth_token=${app_auth_token}' \
 -F 'biz_content={

}'
```

**响应参数说明**

| **参数** | **名称** | **参数类型** | **描述** |
| :--- | :--- | :--- | :--- |
| **coupon_list** | **优惠列表** | Array | 优惠详情列表 |
| **┗ coupon_id** | **优惠 id** | String | 优惠 ID |
| **┗ name** | **优惠名称** | String | 优惠名称 |
| **┗ percent_off** | **百分比折扣** | Number | 百分比折扣，单位：百分比 |
| **┗ amount_off** | **固定折扣金额** | Number | 固定折扣金额，单位：分 |
| **┗ duration** | **持续时间类型** | String | once/repeating/forever |
| **┗ duration_months** | **持续周期数** | Number | 持续周期数 |
| **┗ redeem_by** | **优惠过期时间** | String | 领取截止时间 |
| **┗ active** | **是否可用** | Boolean | 优惠是否可用 |
| **┗ metadata** | **优惠元数据** | String | 商户自定义元数据 |
| **┗ created** | **创建时间** | String | 创建时间 |


**响应示例（查询单个优惠）**

```json
{
 "alipay_trade_promotion_coupon_query_response":{
 "code":"10000",
 "msg":"Success",
 "coupon_list":[
 {
 "coupon_id":"5JXR5XXW",
 "name":"新用户10元立减",
 "amount_off":1000,
 "percent_off":10,
 "duration":"repeating",
 "duration_in_iterations":"3",
 "redeem_by":"2026-02-20 14:10:00"
 }
 ]
 },
 "sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}
```

**响应示例（查询优惠列表）**

```json
{
  "alipay_trade_promotion_coupon_query_response": {
    "code": "10000",
    "msg": "Success",
    "coupon_list": [
      {
        "coupon_id": "Z83YJJAR",
        "name": "新客 5 折优惠",
        "percent_off": 50,
        "duration_type": "once",
        "active": true,
        "created": "2026-05-22T10:00:00Z"
      },
      {
        "coupon_id": "Z83YJJAR",
        "name": "老客 8 折优惠",
        "percent_off": 20,
        "duration_type": "forever",
        "active": true,
        "created": "2026-05-20T10:00:00Z"
      }
    ],
    "total": 2
  },
  "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}
```

## 人群优惠
基于身份识别技术，为 AI 商户提供精准的人群分层定价能力。通过 IIFAA 多因子认证组件，快速验证学生等特定身份，用户无需复杂操作即可享受专属优惠价。

商户可自主配置学生优惠等身份标签，并可设置优惠价格的有效期与使用限制。AI 产品客单价较高，通过身份优惠降低学生等价格敏感群体的使用门槛，提前培育用户心智、扩大品牌覆盖，同时实现精细化用户分层运营。

![](https://mdn.alipayobjects.com/afts/img/A*bdjvQ6IGrzMAAAAASBAAAAgAeq8wAA/original?bz=openpt_doc&t=dJcHaIw-rxJ-bnU7G2lt6uRVoXoScSPo-Lzi5LIi-PcDAAAAZAAAMK8AAAAA)

在完成商品创建后，创建价格时，可以指定该价格需要的准入身份和有效时间，支付宝侧会在用户购买时，核验对应的用户身份，只有满足身份的用户才可以购买；同时，在有效期结束后，自动为用户取消订阅。

### 价格创建
商家可调用 [alipay.trade.price.create（价格创建接口）](https://opendocs.alipay.com/solution/5a02644d_alipay.trade.price.create.md)创建指定身份的价格，获取价格实例id（price_id）。

**注意：**

+ **eligibility_type：** 代表该价格购买时，需要的用户身份类型，具体的值可与支付宝侧确认后传入。
+ **eligibility_expire_time：** 代表用户购买后的有效期，在有效期内，支付宝侧会按照recurring进行周期扣款付费；到期后，支付宝侧会取消订阅，停止对后续的周期扣款续费。
+ **循环计价模型（recurring）**：订阅类商品（含团体席位订阅商品），必传。
    - **计价周期单位（interval）：**与 interval_count组合使用，支持枚举值为 DAY和MONTH，分别代表周期的单位为「天」或「月」。
    - **计价周期间隔（interval_count）：**计价周期间隔，和 **interval** 组合使用。例如 **interval **为 MONTH，**interval_count** = 1，则扣款周期为 1 月：系统以首次购买日期为周期起始日，下一周期起始日按设定间隔顺延，若目标日期不存在则自动调整至当月最后一天。例如首次购买日为1月31日，则下一周期起始日为2月28日（或29日），再下一周期起始日恢复为3月31日。实际扣款将在周期起始日前1天发起，确保资金及时到账，服务无缝续期。

**重要参数说明**

| **参数** | **名称** | **参数类型** | **是否必填** | **最大长度** | **描述** | **示例值** |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| **product_id** | **商品id** | String | 是 | [1,32] | 商品创建接口（alipay.trade.product.create）返回的商品id。 | 202603230010000006783 |
| **unit_amount** | **单位金额** | Number | 是 | [1,1000000000] | 单位金额,单位:分 | 1000 |
| **eligibility_type** | **价格限定购买的身份类型** | String | 是 | [1,32] | 只有满足该类型的身份才可以购买。具体的枚举值待支付宝侧分配。 | STUDENT |
| **eligibility_expire_time** | **指定身份购买后的时效时间** | String | 是 | [1,32] | 满足了eligibility_type的身份购买后，失效的时间。如3d = 3天， 3m = 3月 | 3m |
| **recurring** | **循环计价模型** | Object | 是 | - | 循环计价配置,用于订阅等场景 | - |
| **┗ interval** | **计价周期单位** | String | 是 | [1,32] | 计价周期单位,和interval_count组合使用。枚举值:   + MONTH(月)   + YEAR(年)   + DAY(日) | MONTH |
| **┗ interval_count** | **计价周期间隔** | Number | 是 | [1,10000] | 计价周期间隔,和interval组合使用 | 1 |
| **metadata** | **价格信息元数据** | String | 否 | [1,2000] | 商户需要保存在价格模型中的元数据 | {"key":"value"} |


**请求示例**

```json
curl 'https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.price.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'app_auth_token=${app_auth_token}' \
 -F 'biz_content={
 "unit_amount":1000,
 "product_id":"202603230010000006783",
 "eligibility_type": "STUDENT",
 "eligibility_expire_time":"3m",
 "recurring":{
  "interval_count":1,
  "interval":"MONTH"
 },
 "metadata":"{\"key\":\"value\"}"
}'
```

### 价格查询
商家可调用 [alipay.trade.price.query（价格查询接口）](https://opendocs.alipay.com/solution/97ecc2ab_alipay.trade.price.query.md)，查询已创建的价格信息

重要参数说明： 

+ **出参：**
    - **eligibility_type：** 代表该价格购买时，需要的用户身份类型，具体的值可与支付宝侧确认后传入。
    - **eligibility_expire_time： **代表用户购买后的有效期，在有效期内，支付宝侧会按照recurring进行周期扣款付费；到期后，支付宝侧会取消订阅，停止对后续的周期扣款续费。