本ページでは、サブスクリプション（定期課金）について、課金モデル・頻度・トライアル期間・管理機能の決済手段ごとの違いをまとめます。決済手段の選定やサブスクリプション連携の設計時にご参照ください。
本ページは、利用可能な決済手段の完全な一覧ではありません。ある決済手段がサブスクリプションに対応しているか、および具体的な機能は、加盟店契約の設定と paymethodconfig/inquiry の応答に従います。サブスクリプションのステータスと各回の課金結果は、常に Webhook 通知またはアクティブなクエリを正とします。
2 つの課金モデル
更新課金を誰が主導するかによって、大部分の違いが決まります。
- Waffo 管理 — 顧客が初回決済を承認した後、Waffo が請求サイクルごとに自動で当該決済手段に課金します。カード、Apple Pay、Google Pay、PayPay、その他の主要ウォレット、Paidy がこれに該当します。
- チャネル管理 — 決済チャネルが独自の仕組みで定期課金を発行し、Waffo は主導しません。PIX と DANA（ダイレクト）がこれに該当します。
課金モデルは、アップグレード・ダウングレード、変更、遅延開始などの管理機能が利用できるかどうかを直接左右します（表 B 参照）。
課金と頻度
| 決済手段 | 課金モデル | サブスクリプションモデル | 対応する課金頻度 | クロスカレンシー |
|---|
| カード（Visa / Mastercard クレジット・デビット） | Waffo 管理（初回リダイレクト認証） | 決済優先 / サービス優先 | 日次（1〜365日ごと）/ 週次（1〜4週ごと）/ 月次（1か月以上ごと、上限なし。3＝四半期、6＝半年、12＝年次、24＝2年） | 対応 |
| Apple Pay | Waffo 管理（初回リダイレクト認証） | 決済優先 / サービス優先 | カードと同じ | 対応 |
| Google Pay | Waffo 管理（初回リダイレクト認証） | 決済優先 / サービス優先 | カードと同じ | 対応 |
| PayPay | Waffo 管理（初回リダイレクト認証） | 決済優先 / サービス優先 | カードと同じ。ただし 1 周期は 365 日以内 | 対応 |
| PIX | チャネル管理（初回リダイレクト認証） | サービス優先のみ | 週次（1週ごと）/ 月次（1・3・6・12か月ごと＝月次 / 四半期 / 半年 / 年次）；日次は非対応 | 非対応 |
| DANA（ダイレクト） | チャネル管理（初回リダイレクト認証） | サービス優先のみ | 週次（1〜4週ごと）/ 月次（1か月以上ごと）；日次は非対応；サブスクリプション総期間は 3 年以内 | 非対応 |
| その他の主要ウォレット（GCash、GrabPay、Alipay など） | Waffo 管理（初回リダイレクト認証） | 決済優先 / サービス優先 | カードと同じ | 対応 |
| Paidy（BNPL / 後払い） | Waffo 管理（初回リダイレクト認証） | 決済優先 / サービス優先 | カードと同じ | 対応 |
トライアルとサブスクリプション管理
| 決済手段 | トライアル期間 | サブスクリプション管理（アップグレード・ダウングレード / 変更 / 遅延開始） | ユーザーによる解約 |
|---|
| カード | 無料（0）および有料トライアルに対応。トライアルの頻度は本契約期間と異なってもよい | すべて対応 | 不可（加盟店側のみ） |
| Apple Pay | カードと同じ | すべて対応 | 可（Apple Wallet） |
| Google Pay | カードと同じ | すべて対応 | 可（Google Pay） |
| PayPay | カードと同じ | すべて対応 | 可（PayPay アプリ） |
| PIX | 無料・有料トライアルに対応。トライアルの頻度は本契約期間と一致する必要あり | 近日対応予定 | 可（チャネル側） |
| DANA（ダイレクト） | 対応。トライアルの頻度は本契約期間と一致する必要あり | 近日対応予定 | 可（DANA アプリ） |
| その他の主要ウォレット（GCash、GrabPay、Alipay など） | カードと同じ | すべて対応 | 可（ウォレット側） |
| Paidy（BNPL / 後払い） | カードと同じ | すべて対応 | 可（Paidy 側） |
列の説明
- 課金モデル — Waffo 管理：Waffo がサイクルごとに自動で課金します。チャネル管理：決済チャネルが独自の仕組みで定期課金を発行します。
- サブスクリプションモデル — 決済優先：更新失敗時にサービスを停止し、以降の周期は発行しません。サービス優先：更新失敗時もサービスを継続し、以降の周期も予定どおり発行します。
- 対応する課金頻度 — 「周期タイプ + 間隔」で設定します。独立した「年次」タイプはなく、年次は「月次 × 12」で表します。
- トライアル期間 — 無料（0）または割引トライアルを設定できます。トライアル金額は本契約期間の金額より小さくする必要があります。
- サブスクリプション管理 — API でプランのアップグレード・ダウングレード（
change）、金額の変更（update）、将来の開始設定（遅延開始）ができるかどうか。「近日対応予定」は機能を順次開放中であることを示します。
- ユーザーによる解約 — 顧客が決済手段側で解約できるかどうか（解約は Waffo に反映されます）。すべての決済手段は加盟店側から解約できます。下記の共通ルールを参照してください。
すべての決済手段に共通
- 統一されたサブスクリプション API：作成、照会、解約、管理、変更、修正。
- サブスクリプション作成時、
subscriptionManagementUrl は必須です。
- すべての決済手段は、加盟店側から解約 API を呼び出して解約できます。
- サブスクリプションの返金は、契約の返金ルール（不可 / 全額 / 一部）に従います。
- 更新失敗時、Waffo は自動的に再試行します。デフォルトは 2 回（初回課金を含む）、1 日 1 回です。調整は Waffo までお問い合わせください。
- サブスクリプションのステータス変更と各回の課金結果は Webhook で通知されます。
関連リンク
