決済チャネルが一時的に停止すると、処理中の注文はどうなる?
決済ページが開かない、APIがタイムアウトする、顧客側は引き落とし済みなのに注文が支払い待ちのまま、というのは別々の障害かもしれません。チャネルの一時障害で最も危険なのは、処理中の全注文を失敗にして再支払いを求めることです。稳付payが注文のライフサイクルから、保持すべき状態、追加確認が必要な状態、復旧時の二重請求と重複納品の防止を説明します。
この記事の目次
どこで途切れたのか、決済結果が確定しているかを分ける
支払いリクエスト、チャネル処理、結果応答、コールバック、加盟店の納品は別の段階です。リクエストは届いて処理済みでも、応答が帰路で失われる場合があります。チャネルは正常で、加盟店の通知入口だけが到達不能の場合もあります。ページの失敗やAPIタイムアウトがまず示すのは「今回の通信で信頼できる結果が得られなかった」ことで、支払いが行われていない証明にはなりません。
Adyen公式の障害処理ドキュメントではリクエストのタイムアウトなどを区別し、結果が得られない場合の取引状態照会を推奨しています。ここでは一般原則を引用しており、稳付payが同社APIを使う、またはタイムアウト値を流用するという意味ではありません。支払い結果は、元チャネルの信頼できる照会、署名検証済み通知、必要な照合資料から確定します。
状態表で事実を保持し、タイムアウトで確定結果を上書きしない
| 状態の例 | 判明している事実 | チャネル障害時の対応 |
|---|---|---|
| created:作成済み | ローカル注文はあるが、有効な支払い結果はまだない | 送信を停止して一時利用不可を表示し、支払済みと決めつけない。 |
| pending:支払い待ち・処理中 | 支払い試行があり、結果は未確定 | 元の試行を保持し、通知を受け続け、規則に従って照会する。 |
| paid:支払い確認済み | 信頼できる成功の証拠を得ている | 支払いの事実を保持し、API停止を理由に未払いへ戻さない。 |
| fulfilling:納品処理中 | 発送・有効化・コード納品が開始している | 納品ジョブを調べ、再請求ではなく納品を再試行する。 |
| fulfilled:納品完了 | 対象の商品・権利は提供済み | 納品記録を保持し、重複通知で再提供しない。 |
| expired:ローカルの期限切れ | 加盟店の支払い受付期限が終了している | 元チャネルでの終了を確認し、遅延入金は別途処理する。 |
| unknown:結果の確認待ち | 現在は成功・失敗のどちらも証明できない | 照合キューへ入れ、再支払いを促さない。 |
これらは説明用の業務ラベルで、全チャネル共通のAPI列挙値ではありません。実装では支払い、履行、精算の状態を個別に保存するのが適切です。unknownは確認用フラグでもよく、すでに確定したpaidを消してはいけません。返金、取消、紛争も独立した事象で、「未払い」へ変更して記録の代わりにすることはできません。
新規注文は停止・予備経路へ切り替え、既存注文は元チャネルを保持する
障害確認後は、影響するチャネルへの新規支払いリクエストをまず止めます。条件を満たす新規注文は、検証済みの予備チャネルを利用できます。ただし既存注文のチャネル番号を書き換えるのが切り替えではありません。元の取引は元チャネルで引き続き完了する可能性があります。
各支払い試行に、業務注文番号、チャネル識別子、チャネル取引番号、加盟店口座、金額、通貨、作成時刻を紐付けます。新規注文を切り替えても、既存取引がすべて確認できるまでは旧チャネルの署名検証設定、照会経路、対応関係を残します。残さないと旧取引が成功した際に、更新すべき注文を見つけられなくなります。
利用者が支払い方式の変更を望む場合、元チャネルの能力に応じて、旧試行が取消済み、終了済み、または確実に未払いかを確認します。結果不明のまま別の支払いを作ると、両チャネルで成功する可能性があります。チャネルをまたぐ共通の冪等性は当然には存在せず、追加照合と重複払いへの対応が必要です。
再試行は同じ操作を再利用し、新しい支払いを無制限に作らない
Stripeの冪等リクエストに関する資料では、同じ冪等キーで重複リクエストを識別する方式を説明しています。一般には初回送信前に支払い試行とリクエスト識別子を永続化し、通信異常後は実際のチャネルの再試行規則に従って同じ識別子とパラメーターを再利用します。タイムアウトのたびに別取引を作るのではありません。
ローカル側でも一意制約と並行制御により、複数ワーカーが同じ操作を重複送信しないようにします。注文番号をそのまま冪等キーにできるか、有効期間、再試行可能なエラーは、接続先の仕様で確認します。独自の項目をリクエストに追加するだけで、上流が自動的に冪等性へ対応するわけではありません。
復旧では上限付きのバックオフ再試行を使い、滞留リクエストの一斉送信を防ぎます。支払い確定済みの注文は納品や通知の補完だけを進め、「状態更新」のために決済作成を再実行しません。金額の異なる操作、返金、新たな支払い試行には別の識別子を使い、関連付けを残します。
通知は署名検証して確実に保存してから業務を進める
Webhookは重複・遅延したり、照会応答と前後して届いたりします。受信側は仕様に従って署名、生のリクエスト、時間条件を検証し、口座、注文、金額、通貨、イベント種別を照合します。送信元アドレスは補助にはなりますが、署名や業務項目の検証を代替しません。
有効なイベントを永続的な受信記録や信頼できるキューへ書き込み、コミット後に合意した受領成功応答を返す設計を勧めます。時間のかかるコード納品や通知は後続ジョブで実行します。メモリーに入れただけで成功応答すると、プロセス停止時に、上流は再送をやめているのに復旧可能なジョブが残らない事態になります。
チャネルのイベント識別子で重複排除し、業務納品にも二段目の一意制約を設けます。同じ支払いに異なるイベントが対応する場合があるため、HTTPリクエストだけを重複排除しても不十分です。Stripe公式Webhookドキュメントも、重複イベントと到着順序の問題を示しています。遅れて届いた支払い待ち情報で確定済み成功を上書きせず、納品ジョブの再実行でもコードを二重発行しません。
復旧を支える3つの経路:通知再送・取引照会・照合
- 通知の再送入口を復旧し、未処理の有効な通知を再実行する。
- 能動的な取引照会元チャネルと取引識別子で未確定の支払いを確認する。
- 差異の照合チャネル記録、ローカル支払い、履行記録を比較する。
取引照会にも制限や一時障害があるため、分割して実行し、直近の信頼できる結果を記録します。照会の成功は支払いの成功ではなく、業務結果の読み取りが必要です。内容の欠落や矛盾があれば確認待ちを維持し、最終結論を推測しません。
照合は「チャネルにあるがローカルにない」「支払済みだが未納品」などの差異を見つけるために行います。Adyenの照合ドキュメントは取引単位・バッチ単位の確認方法を示していますが、当サイトはその帳票項目を流用しません。支払い確認、顧客への納品、加盟店の資金精算は個別に確認します。USDTリアルタイム精算に対応していても、注文状態の復旧を代替できません。
期限後入金と返金は別のフローで処理する
加盟店ページのカウントダウン終了はローカルの支払い期限が終わったことだけを意味し、チャネルで取引が取り消されたとは限りません。遅延通知では「期限内に支払ったが通知が遅れた」と「期限後に支払った」を区別し、実際の支払い時刻と通知時刻を保存します。一律に破棄したり、解放済み在庫を無条件で復元したりしてはいけません。
期限後の支払いが有効で納品可能なら、事前に説明した規則で復旧できます。納品できなければ手動照合か合意した返金フローへ進みます。返金申請、処理中、完了は別々に記録し、リクエスト送信だけで「着金済み」と伝えません。結果は対象チャネルの確認と着金規則に従います。
確認済み支払いは、障害中もその事実と関連証拠を保持します。実際の返金や取消が発生したら、そのイベントと金額を追加記録し、支払い記録を削除しません。利用者へ説明でき、後日の照合でも全経緯を再現できます。
2つの事例:再請求ではなく注文を復旧する
事例1:スキャン支払いは引き落とし済みだが、加盟店ページは待機表示のまま
上流の支払いは完了しているものの、加盟店の通知入口が一時的に利用不能なケースです。結果確認中の表示を保ち、元取引の照会と通知の対応を残します。復旧後、有効な再送や照会でpaidを確認して1回だけ納品します。直ちに注文を閉じて再スキャンを求めると、新旧両方が成功し、二重払いとサポート負担が増える可能性があります。
事例2:支払済み注文のコード納品がタイムアウトし、その後重複通知が届く
paidは記録済みでも、納品ワーカーが実行後すぐ結果を報告できなかったケースです。復旧ジョブは納品記録や予約コードとの紐付けを調べてから再納品を判断します。2回目の通知は状態補完だけを行い、2つ目のコードを消費したり支払いを作り直したりしません。利用者にコードが見えたか不明なら手動確認へ進み、タイムアウトだけで「絶対に未納品」と決めつけません。以上は説明用の事例で、実際の事故記録ではありません。
段階別に調べ、実際の進捗を利用者に伝える
- 段階1・入口異常:決済ページ、DNS、証明書、API応答を確認し、新規注文だけの影響か判断する。影響する入口を停止する。
- 段階2・結果不明:未確定の支払い試行をまとめ、元チャネルの識別子を照合し、重複送信を制限して取引照会を行う。
- 段階3・入金済み未納品:永続イベント、キューの滞留、納品記録を確認し、冪等性を保って権利の提供を優先する。
- 段階4・記録と実態の不一致:遅延入金、重複払い、返金を照合し、証拠を残して担当者を割り当てる。
利用者には「現在、支払い結果を確認中です。重複してお支払いにならず、元の注文での対応をお待ちください」と案内できます。確認後は「支払いを確認しました。商品を処理中です。再度のお支払いは不要です」とします。新規注文のみの障害なら「この方式は一時的に利用できません。利用可能な方式を選べますが、送信済み注文は元の支払い結果を先にご確認ください」と伝えます。
通知には影響範囲、判明している状態、その後の連絡方法を記載し、未確認の固定復旧時間を約束しません。稳付payの加盟店管理画面は開発中です。現在の導入・異常照合は実際のお問い合わせ先からご相談ください。本稿の照会、再送、再試行はシステム設計上の提案であり、当サイトで公開済みのボタンやAPIではありません。
参考資料・技術ドキュメント
以下の公式資料は、プロトコルと実装原理の確認に使用しています。コードと事例は技術説明のためのもので、具体的な環境と正式な連携仕様はそれぞれ検証してください。