Skip to main content
本ページでは、サブスクリプション(定期課金)について、課金モデル・頻度・トライアル期間・管理機能の決済手段ごとの違いをまとめます。決済手段の選定やサブスクリプション連携の設計時にご参照ください。
本ページは、利用可能な決済手段の完全な一覧ではありません。ある決済手段がサブスクリプションに対応しているか、および具体的な機能は、加盟店契約の設定と paymethodconfig/inquiry の応答に従います。サブスクリプションのステータスと各回の課金結果は、常に Webhook 通知またはアクティブなクエリを正とします。

2 つの課金モデル

更新課金を誰が主導するかによって、大部分の違いが決まります。
  • Waffo 管理 — 顧客が初回決済を承認した後、Waffo が請求サイクルごとに自動で当該決済手段に課金します。カード、Apple Pay、Google Pay、PayPay、その他の主要ウォレット、Paidy がこれに該当します。
  • チャネル管理 — 決済チャネルが独自の仕組みで定期課金を発行し、Waffo は主導しません。PIX がこれに該当します。
課金モデルは、アップグレード・ダウングレード、変更、遅延開始などの管理機能が利用できるかどうかを直接左右します(表 B 参照)。

課金と頻度

Waffo 管理の更新日時の計算方法

以下のルールは、Waffo 管理の自動更新にのみ適用されます。チャネル管理の Subscription では、決済チャネルが独自の仕組みで更新日時を計算します。 Waffo は、Subscription の作成日時ではなく、初回課金が実際に成功した日時を初期の課金基準日時として使用します。各回の更新日時は次の式で計算します。 次回課金日時 = 現在の課金基準日時 + periodInterval × periodType
例: 初回課金が 2026 年 1 月 31 日 10:30:00 に成功し、MONTHLY + periodInterval: "1" を設定している場合、次回課金日時は 2026 年 2 月 28 日 10:30:00 です。2 月 28 日が課金カーソルに書き戻された後、その次の課金日時は 2026 年 3 月 28 日 10:30:00 になります。
ある期間の初回課金が失敗し、その後の再試行で成功した場合、再試行の成功日時が新しい課金基準日時になります。

トライアルとサブスクリプション管理

列の説明

  • 課金モデル — Waffo 管理:Waffo がサイクルごとに自動で課金します。チャネル管理:決済チャネルが独自の仕組みで定期課金を発行します。
  • サブスクリプションモデル — 決済優先:更新失敗時にサービスを停止し、以降の周期は発行しません。サービス優先:更新失敗時もサービスを継続し、以降の周期も予定どおり発行します。
  • 対応する課金頻度 — 「周期タイプ + 間隔」で設定します。独立した「年次」タイプはなく、年次は「月次 × 12」で表します。
  • トライアル期間 — 無料(0)または割引トライアルを設定できます。トライアル金額は本契約期間の金額より小さくする必要があります。
  • サブスクリプション管理 — API でプランのアップグレード・ダウングレード(change)、金額の変更(update)、将来の開始設定(遅延開始)ができるかどうか。「近日対応予定」は機能を順次開放中であることを示します。
  • ユーザーによる解約 — 顧客が決済手段側で解約できるかどうか(解約は Waffo に反映されます)。すべての決済手段は加盟店側から解約できます。下記の共通ルールを参照してください。

すべての決済手段に共通

  • 統一されたサブスクリプション API:作成、照会、解約、管理、変更、修正。
  • サブスクリプション作成時、subscriptionManagementUrl は必須です。
  • すべての決済手段は、加盟店側から解約 API を呼び出して解約できます。
  • サブスクリプションの返金は、契約の返金ルール(不可 / 全額 / 一部)に従います。
  • PIX と DANA はウォレット側の再試行ルールに従います。Merchant によるカスタマイズには対応していません。
  • サブスクリプションのステータス変更と各回の課金結果は Webhook で通知されます。

関連リンク