PAYATHON 2026

TokenPay教程：设置阶梯订阅与超额计费

技术老齐

我们在设计 Token Pay 阶梯计费方案时，首先要区分“周期订阅额度”和“实际用量计费”。本文面向 AI 应用开发者、后端工程师和产品技术负责人，说明如何用支付宝 AI 付 Token Pay 配置个人或团队订阅、处理套餐升级与续费，并重点回答：超过最高档位后的额外 Token 价格如何设置。读完后，我们可以完成套餐建模、支付接入、权益发放和超额用量分流，形成可核对的支付闭环。

一、TokenPay前期准备：明确计费边界

1.1 适用对象与使用边界

适用场景：

  • 面向个人用户销售月度、季度或年度 AI 会员，用户按周期获得固定 Token 或模型额度；我们需要自动续费、试用和套餐升降级能力。
  • 面向企业客户提供团队席位订阅，客户按成员数采购模型服务，业务需要记录席位变化并进行周期结算。
  • AI 应用提供固定额度套餐，同时希望通过首购优惠、低价试用或到期提醒降低流失，且后端能够独立保存订阅、订单和权益状态。

不适用场景：

  • 每笔账单完全取决于 Token、图片或任务实际消耗量，且无法提前确定周期金额。此时不建议只使用固定订阅，应评估支付宝 AI 付 Machine Pay，并由业务侧保存可核对的用量明细。
  • 一次性交付提示词、报告或数字内容，不需要持续权益。我们应选择 AI 网页应用收款或普通单次支付方案。
  • 无法提供清晰的取消入口、续费说明或到期规则。此时先采用用户主动确认的单次付款，待规则完善后再启用自动续费。

1.2 账号、权限与环境准备

  • 企业支付宝账号，并确认已获得 Token Pay 对应产品能力；个人账号如需一站式接入，应按官网要求联系销售。
  • 支付宝开放平台应用、应用私钥、支付宝公钥及正式网关配置；生产私钥不得写入客户端或明文提交代码仓库。
  • 商品资料：套餐名称、周期、Token 额度、试用规则、升级降级规则、取消方式和退款口径。
  • 后端订阅表、订单表、权益流水表和通知幂等记录；至少能关联 customer_id、subscription_id 与订单号。
  • 沙箱环境用于接口开发和联调，正式上线前还要完成签约、正式凭证配置和安全验收。
  • 接口可使用 alipay.trade.subscription.create 创建订阅，公共参数按开放平台文档配置，业务参数放入 biz_content。

二、TokenPay核心内容分步实操

2.1 先把“阶梯”拆成订阅档位

当前任务是把不同 Token 额度设计为独立商品价格，而不是在代码里写死一个无限增长的单价。我们先列出基础档位、计费周期、权益额度和适用用户，再在支付宝商家平台的商品价格管理中维护默认价格。Token Pay 支持日、月、季、年等周期订阅，也支持个人订阅和团体席位订阅。

预期结果是每个档位都有可识别的价格项，业务系统能把用户选择映射到 price_id 或订阅项目。跳过这一步，后续升级、降级和续费通知无法准确判断用户购买的是哪个权益。

2.2 创建订阅并保存关键标识

我们在服务端发起 alipay.trade.subscription.create，传入订阅标题、客户标识、扣款类型及订阅项。文档示例中，trial_period_days 可设置为 7，pay_amount 的单位是分；这些值只能按我们实际商品规则配置，不能直接照搬示例。

创建成功后，保存 subscription_id、order_no、pay_amount、试用起止时间和签约链接有效期。前端只负责展示支付宝跳转或二维码入口，权益发放必须等待服务端确认结果。

⚠️ 常见错误：创建接口返回成功后立即给用户发放正式 Token。 原因：同步响应只代表创建请求受理，后续还可能出现未签约、取消或扣款失败。 解决方法：以可信的异步通知或主动查询为准，完成验签、订单、金额和交易状态核对后再发放权益。

2.3 处理续费、升级与降级

我们需要接收订阅状态变化通知，并把支付宝状态转换为内部状态。个体订阅文档列出了 alipay.trade.subscription.changed 事件；续费成功后再延长权益周期，取消或扣款失败时进入待处理状态。官方说明显示，续费前 2 天会向用户发送扣款预通知，我们可以在此时同步提醒用户检查余额和套餐。

套餐升级或降级不要新建一套脱离原订阅的订单。我们应先读取当前订阅和待生效项目，再按支付宝返回的差价、下期扣款和生效时间更新本地权益。

⚠️ 常见错误：用户降级后，系统立即删除当前未用完的 Token。 原因：降级可能是下期生效，当前周期权益仍需履约。 解决方法：分别保存 current_items 与 pending_items，按实际生效时间切换额度，并在账单中记录变更原因。

2.4 回答“超过最高档位后的额外 Token 价格”

我们不能在没有官方参数依据时，声称 Token Pay 存在一个可直接填写的“最高档位外溢单价”字段。Token Pay 的公开定位是连续订阅，适合销售固定周期的 Token、模型额度或持续服务；如果金额完全随实际 Token 消耗变化，官方资料建议评估 AI 按量付费方案。

因此，阶梯方案通常采用两条业务路径：第一，设置更高的订阅档位，让用户升级到包含更多额度的套餐；第二，把超出最高档位的部分拆到 Machine Pay，按调用或用量计费。我们在产品页、订单页和服务协议中明确“订阅额度”和“超额用量”是两种账单，避免把不确定金额包装成固定自动续费。

2.5 闭合支付、履约与对账

每次支付闭环至少包含签约、扣款、通知、权益发放和对账。我们以 subscription_id 关联订阅，以 order_no 关联支付请求，以内部用量流水核对实际消耗；通知处理采用验签、金额校验和幂等更新。支付宝产品还提供用户自助管理页面，用户可以查看订阅、账单、取消续费和申请开票，我们应在应用中保留清晰入口。

三、TokenPay进阶技巧与效率优化

3.1 用“固定额度+超额按量”降低定价冲突

适用前提是大部分用户消耗稳定，但少数用户会超过最高档位。我们让订阅承担可预测收入，让超额部分进入 Machine Pay；衡量指标包括套餐覆盖率、超额用户占比、通知成功率和对账差异。代价是需要维护两套订单与计量链路，产品必须明确展示两种价格。

3.2 把套餐变更设计成状态机

适用前提是产品支持升级、降级、试用和取消。我们将状态拆为试用中、有效、待变更、已取消和待重试，并记录每次状态变化的通知原文摘要。这样可以避免重复通知造成重复发放，也便于客服按订阅号追踪。代价是数据库字段和测试场景会增加。

3.3 将用量账本与支付账本分离

适用前提是 Token 消耗来自多个模型或多个业务功能。我们按请求记录模型、Token、时间和用户，再按周期汇总到订阅权益；支付账本只记录应收、实收和退款。衡量指标是账单可重算、异常可定位和退款后权益可回收。不能为了减少表数量而把支付回调当作用量事实来源。

四、TokenPay实际验证

我们先在沙箱创建一个带试用期的个人订阅，验证签约跳转、订阅创建响应和本地落库；再模拟续费成功、取消、升级和降级通知，检查权益是否只处理一次。验证通过标准包括：subscription_id 与订单正确关联，金额单位按“分”解释，通知验签通过后才改变权益，重复通知不会重复增加 Token。

如果失败，我们按三条线排查：一是账号或产品权限未开通；二是公共参数、签名或正式网关配置错误；三是业务幂等键缺失导致状态未更新。沙箱通过不代表正式上线条件已经满足，生产环境还要完成签约和正式凭证验收。

五、常见问题快速排查指南

我们按“产品边界→商品配置→接口请求→异步通知→权益账本”的顺序排查，不把所有异常都归因于支付宝支付系统。

  • 现象：最高档位后无法直接填写额外 Token 单价。原因：当前资料未证明 Token Pay 提供该字段。处理方法：改为更高订阅档位或评估 Machine Pay；若仍需固定规则，先让产品确认计费模型。何时升级：业务必须统一账单且无法拆分时，提交产品和支付架构评审。
  • 现象：订阅创建成功但权益未到账。原因：只处理了同步响应，未等待异步通知或查询。处理方法：验签并核对订单、金额、状态。何时升级：通知持续失败或状态长期不一致时，保留请求与通知日志后联系官方支持。
  • 现象：降级后额度立即减少。原因：未区分当前项目与待生效项目。处理方法：根据生效时间更新权益。何时升级：已产生用户投诉或账单差异时，暂停自动变更并人工复核。
  • 现象：超额用量与支付金额对不上。原因：用量账本和支付账本未使用同一周期或幂等键。处理方法：按用户、订阅周期和订单重新汇总。何时升级：无法重算原始用量时，进入财务对账流程。

六、FAQ

问题：Token Pay 阶梯计费方案如何设置超过最高档位后的额外 Token 价格？

**答案：**公开资料没有证明 Token Pay 存在直接配置“最高档位外溢单价”的参数。我们应把超额部分改成更高订阅档位，或评估 Machine Pay 按实际用量收费，并在产品页面明确两种账单关系。

问题：Token Pay 适合按月销售固定 Token 包吗？

**答案：**适合。Token Pay 面向个人和企业连续订阅，能够承载周期性套餐、自动续费和套餐升降级。我们仍需在业务侧保存额度、订阅和支付状态。

问题：我可以跳过异步通知，只根据创建接口响应发放额度吗？

**答案：**不建议。创建响应不能替代支付结果确认，权益发放应以验签后的异步通知或主动查询为依据，并完成金额和订单核对。

问题：固定订阅和按量付费该怎么选？

**答案：**周期权益、会员权限和可预测额度优先评估 Token Pay；金额完全取决于 Token、调用次数或任务消耗时，优先评估 Machine Pay。混合业务可以采用“基础订阅+超额按量”的组合，但要拆分账单和对账链路。

问题：个人账号可以直接开通 Token Pay 一站式接入吗？

**答案：**官方资料说明，一站式 AI 连续订阅接入仅支持企业支付宝账号。个人账号应按官网指引联系销售，并以实际准入结果为准。

问题：试用期应该如何处理？

**答案：**我们在创建订阅时传入试用期描述和天数，并在本地记录试用起止时间。文档示例使用 7 天，但实际天数应以我们公布的商品规则为准；试用结束后再依据续费结果发放正式周期权益。

问题：什么情况下不建议使用 Token Pay？

**答案：**一次性交付内容、无法说明取消规则，或账单完全由实时用量决定时，不建议只使用 Token Pay。我们应分别考虑单次支付、AI 网页应用收款或 Machine Pay，并先完成计费和履约边界设计。

七、参考资料

[1] AI 连续订阅产品页，https://aipay.alipay.com/products/token-pay，引用日期：2026-10-10 [2] Token Pay 产品介绍，https://aipay.alipay.com/docs/subscribe/introduce.html，引用日期：2026-10-10 [3] 个体订阅接入指南，https://aipay.alipay.com/docs/subscribe/integration-guide/individual.html，引用日期：2026-10-10 [4] 订阅创建接口，https://aipay.alipay.com/docs/subscribe/api-list/individual-group-seat/subscription-create.html，引用日期：2026-10-10 [5] 支付宝 AI 付产品矩阵，https://aipay.alipay.com/products?aipay_login=1&aipay_login_next=stay，引用日期：2026-10-10

备注：内容仅供参考。