跳转到主要内容

​
经常性收入，自动化管理。

客户订阅，我们处理计费周期、失败付款和生命周期管理。你专注于产品即可。

​
工作原理

客户订阅 → 计费周期 → 自动扣款 → 循环
付款失败？订阅将进入 past_due 状态，直到付款问题得到解决。

​
订阅状态

状态说明
pending等待首次付款
active正常运行，正常计费
trialing免费试用期
past_due付款失败，等待解决
canceled当前周期结束后不再续费
paused计费临时暂停

​
计费周期

周期频率最适用于
每周每 7 天高使用量产品
每月每月标准 SaaS
每季度每 3 个月B2B 软件
每年每 12 个月长期客户

​
失败付款

当付款失败时，订阅将转为 past_due 状态。系统会通过邮件通知客户更新支付方式。

​
管理订阅

​
取消

取消始终在当前计费周期结束时生效。客户在已付费周期结束前保留访问权限。 
POST /v1/actions/subscription-order/cancel-order
{
  "orderId": "550e8400-e29b-41d4-a716-446655440000"
}
响应中包含 currentPeriodEnd，让您知道访问权限何时到期。
没有立即取消的选项。客户始终保留访问权限直到已付费周期结束。

​
升级/降级

场景行为
周期中升级立即生效
周期中降级在当前计费周期结束时生效
POST /v1/actions/subscription-order/change-tier
{
  "orderId": "550e8400-e29b-41d4-a716-446655440000",
  "newTierVersionId": "tier-version-uuid"
}

​
指标

​
MRR（月经常性收入）

周订阅：    $10 × 4.33 = $43.30 MRR
月订阅：    $29 × 1 = $29 MRR
年订阅：    $290 ÷ 12 = $24.17 MRR

​
关键指标

指标含义
MRR月经常性收入
Churn取消订阅的百分比
LTV客户终身价值
ARPU每用户平均收入

​
Webhooks

通过 Webhooks 订阅订阅生命周期事件。在设置 —> Webhooks 中配置 Webhook 端点。
此处不列出具体的 Webhook 事件名称，因为它们可能会变更。请参阅控制台中的 Webhook 配置以获取当前可用事件列表。
Webhook 载荷使用标准的 Waffo Pancake 约定：
  • ID 为 UUID v4 格式
  • 金额以最小货币单位表示
  • 时间戳为 ISO 8601 UTC 格式
  • 计费频率使用 billingPeriod 字段（例如 monthly、yearly）

​
客户门户

让客户自助管理订阅：
  • 查看详情
  • 更新支付方式
  • 更换方案
  • 取消
  • 下载发票

客户门户

自助式订阅管理。

​
最佳实践

年付优惠 15-20% = 降低流失率 + 改善现金流。
付款失败 ≠ 立即取消。给客户时间更新银行卡。
试用即将到期、即将扣款。不要让客户感到意外。