継続収益を自動化。
顧客がサブスクリプションを開始したら、請求サイクル、更新リカバリー、ライフサイクル管理は私たちが処理します。あなたは製品に集中してください。仕組み
past_due に移行します。これはリカバリー状態であり、即時終了の状態ではありません。顧客が支払い情報を更新する間、システムはサブスクリプションを猶予期間またはリトライ期間に保持できます。
サブスクリプションプランの構造
Waffo Pancake では、個別に購入可能なサブスクリプションオプションはそれぞれ独立したサブスクリプション商品です。 最も一般的な区別は請求サイクルです。例：- 月次
- 年次
サブスクリプションステータス
請求サイクル
無料トライアル
登録のハードルを下げ、購入前に顧客にお試しいただけます。トライアルの設定
サブスクリプション商品を作成する際、ダッシュボードでトライアルトグルを有効にし、日数を設定してください。プラットフォームレベルのトライアル保護
Waffo Pancake は Merchant of Record（記録商）として、トライアルの不正利用を自動的に防止します：
2つのレイヤーの相互作用：
- 加盟店のリクエストがプラットフォーム最大値以下の場合 → 加盟店のリクエスト値が使用されます
- 加盟店のリクエストがプラットフォーム最大値を超える場合 → プラットフォーム最大値にフォールバックします
- 加盟店が指定しない場合 → プラットフォーム最大値がそのまま使用されます
有料トライアル
トライアルは無料である必要はありません。トライアル期間中に費用を完全に免除する代わりに、少額の割引金額を請求できます — いわゆる「$1 トライアル」のパターンです。この金額は任意で、通貨ごとに設定でき、常に通常価格より低くなります。トライアル終了後は、自動的に通常価格での請求に切り替わります。API でトライアル価格を設定する
リクエストフォーマットとルールについては
trialAmount フィールドのリファレンスを参照してください。購入者 ID とトライアル保護
トライアル適格性はbuyerIdentity で追跡されます — 認証済みチェックアウトで提供する安定した識別子です。プラットフォームはこれを使用して、セッション間での重複トライアル取得を検出します。
更新リカバリー
更新請求が正常に回収されなかった場合、サブスクリプションはpast_due に移行します。これは通常、顧客が支払い方法を更新する間、サブスクリプションがリトライまたは猶予期間にあることを意味し、アクセスが即座に終了するわけではありません。
一般的な対応には以下が含まれます：
- 顧客に支払い情報の更新を通知する
- 猶予期間中はアクセスを維持する
- 催促ポリシーに基づいて回収をリトライする
past_due は単に「支払いが失敗してサービスが停止した」ではなく、「更新にリカバリーが必要」と捉えてください。サブスクリプション管理
キャンセル
キャンセルは常に現在の請求期間の終了時に有効になります。キャンセルがリクエストされると、サブスクリプションはcanceling の中間ステータスに移行します。顧客は現在の請求期間が終了するまでアクセスを維持し、その時点でステータスは canceled に移行します。
currentPeriodEnd が含まれるため、アクセスがいつ期限切れになるかを把握できます。返されるステータスは canceling（期間がすでに終了している場合は canceled）です。
即時キャンセルのオプションはありません。顧客は常に支払い済み期間の終了までアクセスを維持します。
canceling → canceled の移行は、現在の請求期間の満了時に自動的に行われます。サブスクリプションの再開
サブスクリプションがまだcanceling の場合、顧客は現在の期間が終了する前に再開できます。
再開後：
- サブスクリプションは
activeに戻ります - アクセスは中断なく継続します
- 以降の更新は元の請求サイクルで継続します
再開は、キャンセルされたものの現在の期間の終了にまだ達していないサブスクリプションに適用されます。これは実質的にキャンセルの取り消しであり、新規購入ではありません。
アップグレード/ダウングレード
プラン変更は現在のサブスクリプション注文を終了し、新しい注文を作成します。フィールドを書き換えるものではありません。購入と同じくホスト型チェックアウトページで完了します。
変更が確定すると
subscription.plan_changed が送信され、data.planChange に変更方向・変更前後のプラン名と価格・chargedAmount（今回の実請求額）が含まれます。この 2 件の注文について subscription.activated と subscription.canceled は意図的に送信しません —— 既存の「キャンセル時に権限を剥奪する」処理がプラン変更で誤作動しないようにするためです。
通貨をまたぐ変更はサポートされません。トライアル期間中のサブスクリプションはプラン変更できません。
メトリクス
MRR（月次経常収益）
主要メトリクス
Webhooks
サブスクリプションのライフサイクルイベントを Webhook で受信できます。設定 —> Webhooks で Webhook エンドポイントを設定してください。 Webhook ペイロードは Waffo Pancake の標準的な規約に従います：- ID は UUID v4 形式
- 金額は表示形式の文字列
- タイムスタンプは ISO 8601 UTC
- 請求頻度は
billingPeriodフィールドを使用（例：monthly、yearly）
カスタマーポータル
顧客がセルフサービスでサブスクリプションを管理：- 詳細を確認
- 支払い方法を更新
- プランを変更
- キャンセル
- サブスクリプションの再開
- 請求書をダウンロード
カスタマーポータル
セルフサービスのサブスクリプション管理。
ベストプラクティス
年間割引を提供
年間割引を提供
年額で 15-20% オフ = 解約率低下 + キャッシュフロー改善。
即座にアクセスを遮断しない
即座にアクセスを遮断しない
更新請求の失敗が即時キャンセルを意味する必要はありません。顧客にサブスクリプションを回復する時間を与えましょう。
リマインダーを送信
リマインダーを送信
トライアル終了前、請求前に通知。顧客を驚かせない。