SuperAPI AI 工具集

subscription-integration

通用与其它

查看项目

更新于 10-16 05:06

技能介绍

用途:为使用 Dodo Payments 的循环订阅产品提供结账后管理指南,覆盖订阅创建、生命周期、套餐变更、取消、失败支付恢复与按需扣款。

主要能力:通过 Checkout Sessions 创建订阅(可设 trial_period_days 进入试用);订阅状态含 pending、active、on_hold、cancelled、failed、expired,试用期订阅显示为 active,subscription.renewed 是事件而非状态;失败支付可进入可恢复的 on_hold 或终止的 failed。支持套餐升降级,proration_billing_mode 可选 prorated_immediately、difference_immediately、full_immediately、do_not_bill,并可先 previewChangePlan 预览费用、取消已排期变更。取消支持立即 update status 为 cancelled,或 cancel_at_next_billing_date 到期终止。按需扣款用 mandate_only 创建订阅后调用 subscriptions.charge,金额以最小货币单位计。客户门户支持查看订阅、更新支付方式、取消、升降级,链接 24 小时过期。

使用方式:服务端用 client.checkoutSessions.create 生成托管结账并跳转 checkout_url;订阅操作用 subscriptions.retrieve、updatePaymentMethod、changePlan、cancelChangePlan、retrieveUsageHistory、retrieveCreditUsage 等。状态变更通过 Webhook 处理,如 subscription.active、renewed、on_hold、plan_changed、cancelled、failed、expired,需校验签名并做幂等。

限制:不应在 return_url 授权访问,应等待 subscription.active;subscriptions.create 已弃用;changePlan 必须指定 proration 模式;on_hold 不等于暂停,无通用暂停/恢复;按需扣款不会自动重试,需自行实现;重试仅针对软拒付,dunning 邮件耗尽后不改变订阅状态。其他细节资料未提供。