营销工具包
更新时间：
产品特色
营销工具包 为AI商户打造一站式营销解决方案。
优惠 支持「百分比折扣」和「固定金额减免」两种模式，并可设置折扣持续时间、特定人群方案，覆盖首购优惠、长期会员折扣、教育优惠等多元营销场景。此外，支付宝提供「先体验后付费」的订阅模式。
| 营销策略 | 场景案例 |
|---|---|
| 用户拉新 | 5元试用7天，后续订阅48元/月。 |
| 老客留存 | 连续按月订阅享受8折优惠 |
| 人群优惠 | 通过学生认证后，享受5折优惠 |
以下图片仅做线上样式参考，实际页面内容以线上为准。
试用期订阅
试用期 为用户提供「先体验后付费」的订阅模式，支持免费试用。试用结束后，系统自动按原价续费，用户感知平滑，无需重新订阅，帮助 AI 商户快速获客并提升转化率。
| 场景 | 典型策略 |
|---|---|
| 新用户体验 | 提供3天免费试用，降低首购决策门槛 |
| 新产品体验 | 针对特定项目设置试用，引导用户体验新产品 |
- 试用期时长：仅传入天数，建议试用期设置在3-7天。
- 试用期金额：支持灵活设定
以下图片仅做线上样式参考，实际页面内容以线上为准。
创建试用期
在alipay.trade.subscription.create（订阅创建接口） 接口下，支持试用期的核心参数：
- 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 | 支付金额，单位分； 仅用于商户自定义金额，若传了该值，用户实际支付金额会以该值为准 |
请求示例（带试用期）
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×tamp=${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 |
| trial_end | 试用期结束时间 | String | 试用期结束时间，格式：yyyy-MM-dd HH:mm |
| alipay_jump_schema | 支付宝长链跳端 schema | String | 长链，适用于跳转拉起支付宝客户端 |
| alipay_schema | 支付宝跳转的 schema | String | 短链，适用于生成二维码 |
| pay_amount | 支付金额 | Number | 实际支付金额，单位：分（试用期通常为 0） |
响应示例
{
"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（订阅查询接口）查询试用期的状态和信息。
重要参数说明
| 参数 | 名称 | 参数类型 | 是否必填 | 最大长度 | 示例值 | 描述 |
|---|---|---|---|---|---|---|
| subscription_id | 订阅 id | String | 是 | [1,64] | 2026050800300499484 | 订阅 ID |
| customer_id | 支付宝客户 id | String | 是 | [1,64] | 202605080030600439037 | 支付宝客户 ID |
请求示例
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×tamp=${now}' \
-F 'app_auth_token=${app_auth_token}' \
-F 'biz_content={
"subscription_id":"2026050800300499484",
"customer_id":"202605080030600439037"
}'响应参数说明（试用期相关）
| 参数 | 名称 | 参数类型 | 描述 |
|---|---|---|---|
| trial_start | 试用期开始时间 | String | 试用期开始时间 |
| trial_end | 试用期结束时间 | String | 试用期结束时间 |
响应示例（试用期信息）
{
"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（订阅营销优惠创建接口）创建灵活的折扣策略，支持百分比折扣和固定金额减免，并可设置折扣持续时间。
注意：
- 优惠创建时需要指定折扣类型：百分比折扣（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 | 优惠领取截止时间，过期后新订阅不可用 |
| metadata | 优惠元数据 | String | 否 | [1,2000] | {“key”:“value”} | 商户自定义元数据 |
请求示例
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×tamp=${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 | 创建时间 |
响应示例
{
"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（订阅创建接口）使用优惠
重要参数说明
| 参数 | 名称 | 参数类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 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来获取本次应支付的金额 |
注意：其它参数若有传参需要，请与支付宝技术支持沟通确认
请求示例
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×tamp=${now}' \
-F 'app_auth_token=${app_auth_token}' \
-F 'biz_content={
"customer_id": "202603291031500001001",
"items": [
{
"price_id": "202604130020000046658",
"coupon_id": "5JXR5XXE"
}
]
}'响应示例
{
"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（订阅修改接口）使用优惠
订阅升级参数说明
| 参数 | 名称 | 参数类型 | 是否必填 | 最大长度 | 示例值 | 描述 |
|---|---|---|---|---|---|---|
| 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，升级时可使用优惠券抵扣 |
注意：其它参数若有传参需要，请与支付宝技术支持沟通确认
升级请求示例
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×tamp=${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"
}
]
}'响应示例
{
"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（订阅营销券查询接口）查询已创建的优惠信息。
重要参数说明
| 参数 | 名称 | 参数类型 | 是否必填 | 最大长度 | 示例值 | 描述 |
|---|---|---|---|---|---|---|
| coupon_id | 优惠 id | String | 否 | [1,64] | Z83YJJAR | 优惠 ID，不传时返回所有优惠列表 |
请求示例（查询单个优惠）
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×tamp=${now}' \
-F 'app_auth_token=${app_auth_token}' \
-F 'biz_content={
"coupon_id":"29XGG87G"
}' 请求示例（查询所有优惠）
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×tamp=${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 | 创建时间 |
响应示例（查询单个优惠）
{
"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"
}响应示例（查询优惠列表）
{
"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 产品客单价较高，通过身份优惠降低学生等价格敏感群体的使用门槛，提前培育用户心智、扩大品牌覆盖，同时实现精细化用户分层运营。
在完成商品创建后，创建价格时，可以指定该价格需要的准入身份和有效时间，支付宝侧会在用户购买时，核验对应的用户身份，只有满足身份的用户才可以购买；同时，在有效期结束后，自动为用户取消订阅。
价格创建
商家可调用 alipay.trade.price.create（价格创建接口）创建指定身份的价格，获取价格实例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”} |
请求示例
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×tamp=${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（价格查询接口），查询已创建的价格信息
重要参数说明：
- 出参：
- eligibility_type： 代表该价格购买时，需要的用户身份类型，具体的值可与支付宝侧确认后传入。
- **eligibility_expire_time： **代表用户购买后的有效期，在有效期内，支付宝侧会按照recurring进行周期扣款付费；到期后，支付宝侧会取消订阅，停止对后续的周期扣款续费。