用途:autumn-add-payments 用于在应用中接入 Stripe 结账与支付流程,由 Autumn 处理结账、升级、降级和取消等操作。官方提示始终以 docs.useautumn.com 的代码示例和最新 API 为准。
主要能力:提供 checkout 与 attach 两个核心动作。checkout 对新客户返回 Stripe URL,对已有卡片的客户返回预览数据;attach 用于卡片已在档时确认购买。checkout 结果包含 url(Stripe 结账链接,卡片已在档时为 null)、product、current_product、lines、total、currency 等字段。产品场景包括 new、active、scheduled、upgrade、downgrade、renew,分别对应未订阅、当前计划、已排期、升级、降级、已取消需续订。
使用方式:React 使用 autumn-js/react 的 useCustomer 与 usePricingTable;后端使用 autumn-js 的 Autumn 类,传入 secretKey(如 process.env.AUTUMN_SECRET_KEY)。checkout 返回 URL 时跳转,否则展示确认对话框后调用 attach。取消可用 cancel,或通过 attach 切换到免费方案完成降级。支持预付费或按席位定价,可在 checkout 时通过 options 传入 feature_id 与 quantity。成功后可传 success_url 指定 Stripe 结账后的跳转地址。按钮文案可根据 scenario 与 properties.has_trial 生成,例如试用、当前计划、升级、降级、订阅。
适用场景:需要快速接入 Stripe 订阅与支付、处理升降级和预付费计量的 Web 应用。
限制与注意:URL 字段为 data.url,而非 data.checkout_url;不要自建升降级逻辑,应使用 products.list 获取场景;升降级按比例计费由 Autumn 自动处理;取消时优先切换到免费方案而非硬取消;具体功能、收费和平台支持以官方文档为准,资料中未提供更多细节。