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