SuperAPI AI 工具集

subscription-billing

编程与开发

查看项目

更新于 10-16 04:32

技能介绍

用途:当系统需要按周期向客户收费,并要在 Stripe Billing 上建模订阅生命周期(创建、试用、升级、降级、取消、暂停、恢复、催收)时使用;也用于选择按比例计费行为、Smart Retries 策略、催收结束处置、计量定价、自动税务或多币种 Price,以及就订阅制与永久授权、月付与年付给出建议。

主要能力:梳理订阅数据模型(Customer、Product、Price、Subscription、SubscriptionItem、Invoice),说明各订阅状态含义与权益规则;给出创建订阅、试用、周期中变更与按比例计费、取消/暂停/恢复、Smart Retries 催收、计量计费、定价模型、税务与上线检查清单等流程;强调 Price 追加式约定、显式设置 proration_behavior、以 Webhook 为唯一可信状态信号。

使用方式:先读完整 SKILL.md,再按需加载 stripe-payments 等配套技能;先确定套餐目录与 Price 策略,再实现创建、试用、周期中变更与取消路径;上线前配置 Smart Retries 与催收结束处置并接入 Webhook;仅在需要时加入税务与计量计费。示例命令:curl https://api.stripe.com/v1/subscriptions -u "<<YOUR_SECRET_KEY>>:" -d customer={{CUSTOMER_ID}} -d "items[0][price]={{PRICE_ID}}"。

适用场景:SaaS 订阅计费设计、生命周期策略评审、催收与收入恢复配置、计量计费与税务接入。

限制:不适用于一次性支付、Webhook 签名验证或 3DS/SCA 原语(用 stripe-payments);不适用于收入确认与递延收入(用 saas-accounting-system);不适用于 MRR/ARR 分析与增长实验(用 saas-growth-metrics)。计量计费部分仅作叙述,未确认具体端点与参数前不应编造;试用优惠不能与 Stripe Checkout 或旧版 trial_end 同时使用。