サブスクリプションの引き落としが失敗しました。Waffo は自動で再試行しますか？
はい。サブスクリプションの再試行を貴社が自ら起動する必要はまったくなく、同じ期間に対して代替の注文を作成すべきでもありません。- その期間の注文は再試行が必要な状態になり、Waffo は貴社の契約の再試行戦略から導かれるスケジュールで再度試行します。
- 失敗理由と試行回数を含め、すべての試行がサブスクリプション決済注文の通知で配信されるため、ポーリングせずに一連の流れを追えます。
- 再試行が進行中でも、サブスクリプション自体は動き続けます。ある期間が失敗してもステータスは変わりません。
再試行のスケジュールはどう決まりますか？
貴社の収単契約上の再試行戦略によって決まり、戦略は単一のグローバル設定ではなく課金サイクルごとに選択されます。Waffo はサブスクリプションのperiodType と periodInterval から、6 つのバケットのいずれかに戦略を解決します。マッピングはサイクルの長さによって行われ、バケットの境界は名前から想像される位置にはありません。
驚かれやすい 2 つの帰結：四半期のサブスクリプション（
MONTHLY + 3）は QUARTERLY ではなく MONTHLY のバケットを使います。そして 半年のもの（MONTHLY + 6）が QUARTERLY に入ります。DEFAULT は、解決されたバケットに対して貴社の契約に戦略が設定されていない場合にも使われます。
各バケットは 3 つのつまみを持ちます。再試行の間隔、間隔の単位（日）、そしてその期間についての最大試行回数です。これらの値はプラットフォームの定数ではなく商業上の条件です。貴社アカウントに設定されているポリシーは Waffo の担当者にお尋ねください。また、想定したスケジュールを照合ロジックにハードコードしないでください。
期間ごとの最大回数に加えて、再試行全体の上限はありますか？
はい。貴社の契約の期間ごとの最大回数とは独立に、カードの再試行はアカウント全体のローリングウィンドウによって制限されます。これは Waffo が再試行頻度に関するカードスキームのルールの範囲内に留まるためです。- ウィンドウは暦ベースではなくローリングです。暦月ではなく常に直近の期間を見ます。
- 試行がウィンドウを超えてしまう場合、その試行は失敗にはならず、収まる最初の日付へ繰り延べられます。
- Waffo は数値の上限を公開していません。これは Waffo のプロダクト上の判断ではなく、カードスキームの要件に追従するものだからです。契約の間隔から予測されるより後に再試行が行われ得る理由として捉えてください。
Waffo はいつ再試行をやめますか？サブスクリプションはどうなりますか？
次のいずれかが成り立つと再試行は終了します。
重要な点であり、最もよく混乱を招く部分：
再試行が尽きたとき、クローズされるのはその課金期間の注文だけです。サブスクリプション自体のステータスはそのままで、キャンセルや一時停止の状態に移ることはなく、次の期間は予定どおり試行されます。
したがって、クローズされた期間の注文は、顧客のアクセス権を恒久的に取り消すシグナルではありません。督促の挙動（N 期間失敗したら権利を停止し、M 期間で解約するなど）が必要な場合は、期間単位の通知をもとに貴社側で実装し、ポリシーに従って自らキャンセル API を呼び出す必要があります。
特定の失敗が再試行可能かどうかを API のレスポンスから判断できますか？
専用のフラグからは判断できません。現在のリリースでは、サブスクリプションの失敗レスポンス、非同期通知、照会レスポンスのいずれにも加盟店向けの「再試行可能」フィールドはありません。次のものから状況を判断してください。- 期間の注文のステータス（再試行中か、クローズ済みか）
- その試行に対して返された失敗コード
- 通知に含まれる試行回数を、貴社の契約の戦略と突き合わせたもの
retryPayment や retryAble のフィールドを前提にロジックを組まないでください。これらは加盟店との契約の一部ではなく、貴社向けに値が入ることもありません。
再試行が保留中のままサブスクリプションをキャンセルしました。その再試行は止まりますか？
契約上の 1 つの設定によります。また、その範囲は「すべてが止まる」よりも狭いものです。- 次の再試行を待っている注文はキャンセル時にクローズされます。ただし、契約でキャンセル時に再試行をクローズする設定が有効になっている場合に限ります。この設定は既定ではオフなので、キャンセル後に一切の試行が行われないことが要件であれば、Waffo の担当者に確認してください。
- すでに決済手段へ送信された注文が、キャンセルによって強制的にクローズされることはありません。資金がすでに動いている可能性があるため、Waffo は結果を待ち続け、実際の結果を報告します。キャンセル済みのサブスクリプションでも、最後に 1 件の成功または失敗の通知が発生し得ると想定してください。
- すでに最終状態にあった注文は影響を受けません。
1 つのサブスクリプションに複数の決済手段を持てますか？
はい。サブスクリプションは順序付きのリストを持ちます。1 つのデフォルトの決済手段と、優先順位を持つ任意の数のバックアップです。ユーザーはホスト型のサブスクリプション管理ページで自らリストを管理します。サブスクリプション詳細のレスポンスはcanChangePaymentMethod と登録済みのリストを返すため、貴社独自のビューを描画できます。
登録された各決済手段には独自のステータスがあります。
決済手段を追加するとゼロ金額の注文が作成されるのはなぜですか？
Waffo が課金する前に、その決済手段が課金可能であることを証明する必要があるからです。ユーザーが決済手段を追加すると：- Waffo はその決済手段を検証するためのゼロ金額のオーソリ注文を作成します。
- レスポンスは、ユーザーがオーソリを完了するためのチェックアウトリンクを返します。リンクはキャッシュされるため、同じ決済手段で追加を再試行しても、2 回目の試行が開かれるのではなく同じリンクが返ります。
- 決済手段は
IN_PROGRESSとして保存され、デフォルトにはなりません。 - オーソリに成功すると
ACTIVEに変わります。その後に資格情報を解決できない場合は、代わりにCLOSEDになります。保留のまま静かに残ることはありません。
デフォルトの決済手段で課金に失敗するとどうなりますか？
バックアップが登録されている場合、Waffo は再試行の間隔を待たずに、優先順位の順で即座にバックアップを試します。それがバックアップの意義そのものです。数日にわたる再試行サイクルを、同じ瞬間の 2 回目の試行に変えます。- バックアップ試行の次回再試行時刻は現在に設定されます。
- バックアップの試行はローリングウィンドウに加算されないため、デフォルトの決済手段の枠を消費しません。
- バックアップの試行は、ユーザーへの再試行終了のメールを発生させません。
- すべてのバックアップを試して失敗すると、デフォルトの決済手段が戻され、通常の間隔ベースの戦略が再開します。
どの決済手段の変更がブロックされますか？
ユーザーのカードがもうすぐ期限切れです。Waffo は警告しますか？カードを更新しますか？
どちらも前提にすべきではありません。ここは最もよくある誤解なので、注意して読んでください。- Waffo はイシュアー側のカード更新情報から保存済みカードを更新しません。 自動のアカウントアップデーターの連携はありません。銀行が新しい番号や有効期限でカードを再発行しても、保存された資格情報が静かに追従することはありません。再登録を前提に計画してください。
- Waffo は、有効期限が近づいている決済手段についてサブスクリプション詳細のレスポンスに期限間近のフラグを出すため、貴社のプロダクト内でユーザーに促すことができます。メールではなくこのフラグを、行動すべきシグナルとして扱ってください。
- 有効期限が過ぎると、日次のチェックがその決済手段を
EXPIREDに移し、課金できなくなります。 - ウォレット型の保存済み決済手段は異なります。ウォレット自身が資格情報の更新や連携解除を Waffo に通知する場合、その更新は適用されます。これは通常の保存済みカードには及びません。
購入者のカードが、課金の前にチェックアウトで拒否されました。なぜですか？
一部のカード商品は継続課金に適しておらず、貴社の契約はサブスクリプション向けにブロック対象のカードサブタイプの一覧を持ち得るためです。チェックアウト中に Waffo はカードの BIN を照会し、そのサブタイプが一覧にあればカード系の決済手段は選択肢から除外されます。何も残らない場合、購入者には次のようなメッセージが表示されます。Sorry, we do not accept this type of card for subscriptions. Please try a different card (e.g., standard Credit or Debit card).対処にあたっての注意：
- 一覧は契約ごとに設定されます。プラットフォーム全体で固定のブロックリストはないため、貴社アカウントに何が設定されているかは Waffo の担当者にお尋ねください。
- チェックは、サブスクリプションを作成するときではなく、購入者が実際に入力したカードに対してチェックアウト時に行われます。したがって、サブスクリプションの作成が成功しても、購入者がチェックアウトページで断られることがあります。
- 復旧の経路は他の決済拒否と同じです。購入者に別のカードを依頼してください。同じカードで再試行しても結果は変わりません。
numberOfPeriod を渡しませんでした。サブスクリプションはいつ終了しますか？
numberOfPeriod の省略は実質的な「無期限」を意味しません。貴社の契約はサブスクリプションの最大継続年数を持ち、Waffo はそこから総期間数を解決します。
numberOfPeriodを省略した場合、総期間数と終了時刻は開始時刻に契約の最大継続期間を加えて導出されます。作成リクエストは受理され、何も拒否されません。導出された値は最初の期間が成功した時点で書き込まれるため、自分で計算するのではなくサブスクリプションから読み戻してください。numberOfPeriodを指定したが、最後の引き落としがその最大継続期間を超えてしまうほど長い場合、作成は切り詰められるのではなく拒否されます。同じチェックはnumberOfTrialPeriodにも適用されます。返るのは「利用可能な決済手段がない」エラーですが、このケースでは「このカードはサポートされていない」ではなく「これほど長いサブスクリプションを担える契約がない」という意味です。
EXPIRED に移り、新しいものを登録する必要が生じるだけです。