なぜマルチPG切り替えで事故が起き、どこから防ぐべきか?
取引規模の拡大や海外決済・簡単決済の拡充に伴い、単一の決済代行会社(PG)だけに依存することは難しくなります。手数料交渉力を高め、特定のPGやカード会社・VAN区間の障害による売上損失を抑えるために2社以上のPGを接続します。しかし、2つのAPIを条件分岐でつなぎ合わせただけの構造は、障害時に売上を守るどころか二重決済と精算漏れを先に引き起こします。
事故が集中する箇所は主に3つです。1つ目は、主力PGの承認応答が遅れた際、先行取引の成否を確定させないまま補助PGへ新しい承認を要求するケースです。2つ目は、ルーティング規則を変更した後、過去の注文の取消・部分返金要求が元取引のPGではなく新しいPGへ送られるケースです。3つ目は、PGごとに異なるWebhookの再送規則や精算ファイル形式が注文状態を互いに上書きするケースです。[2][6]
マルチPGアーキテクチャの目的は、決済会社名を動的に差し替えることではありません。注文・会計システムが個別PGの応答形式に振り回されないよう共通のゲートウェイ層を置き、どの取引がどのPG・加盟店アカウント(MID)でどの状態として処理されたかを追跡可能な単一元帳で束ねることが核心です。[7]
単一PG環境における注文・決済・提供状態の分離は決済は成功したのに注文がない:決済・注文状態を合わせる設計で扱っています。本稿ではその状態モデルの上に複数のPGと簡単決済を載せる際に必要なアダプター境界、障害迂回条件、課金キーの制約、取消の帰属、および精算正規化の基準を整理します。
注文ロジックとPGアダプターはどのような境界で分けるべきか?
新しい決済会社を追加するたびにカート、注文画面、クーポン控除、返金画面、管理画面をすべて修正しなければならないなら、ゲートウェイ層が存在しない状態です。注文システムは「この注文でいくら承認・取消すべきか」だけを知り、PG別のパラメータ組み立てや署名検証はゲートウェイ内部のアダプターが担う必要があります。
共通層とアダプターの責務を分ければ、決済会社を1社追加する際の変更範囲をアダプター1モジュールと精算パーサー1つに閉じ込められます。Toss Paymentsのようにクライアント認証後にサーバー承認(confirm)を呼び出すフローも、海外PGのPayment Intentベースのフローも、内部では同一の決済試行ライフサイクルへマッピングします。[2][5]
| レイヤー | 担当する役割 | 保持すべき主要データ | 個別PGアダプターへ委譲する処理 |
|---|---|---|---|
| 注文・請求レイヤー | 購入金額の計算、割引・在庫の確定、商品提供の指示 | 内部注文ID、品目別の決済対象金額、履行状態 | なし(PG名を直接参照しない) |
| 決済ゲートウェイコア | ルーティング決定、決済試行の生成、べき等性制御、状態遷移 | 決済試行ID、選択されたPG・MID、内部標準状態、ルーティング理由 | 承認・取消・照会の呼び出し時点と再試行上限の指示 |
| PGアダプターレイヤー | PG別API呼び出し、認証ヘッダー・べき等キー生成、応答コード変換 | PG原本取引キー、PG原本応答コード・時刻、要求ペイロードハッシュ | 各PG仕様に合わせたHTTP要求とエラーコードのマッピング |
| Webhook・突合収集器 | 署名検証、重複イベント排除、精算ファイルの標準化 | Webhook受信ID、正規化された取引・手数料・精算予定日レコード | PG別の署名アルゴリズム検証およびCSV・APIパース |
内部標準状態には特定PGの文字列をそのまま使いません。たとえば PREPARED(試行生成)、AUTH_COMPLETED(認証完了・承認前)、CAPTURE_PENDING(承認要求中・結果未確定)、CAPTURED(承認確定)、CANCEL_REQUESTED(取消進行中)、CANCELED(取消確定)、FAILED(明確な拒否)のように、自社システムの次の行動を基準に定義します。[2][4]
決済試行ごとにPGと加盟店識別子を不変データとして残す
1つの注文で1回目のPG呼び出しが拒否され、2回目のPGで再決済した場合、内部注文は1件ですが決済試行は2件になります。各決済試行レコードには選択したPGコード、加盟店ID(MID)、通貨、適用されたルーティング規則の版、およびべき等キーを生成時点で固定して保存します。[3][5]
この時点の記録がなければ、後から管理画面で「なぜこの注文がB決済会社へ回ったのか」を説明できず、部分取消や精算突合でもどの加盟店アカウントを照会すべきか失われます。決済会社を追加する前の選定基準はPG選定ガイドで併せて点検できます。
共通の取引仕様で複数の決済経路を接続 — 決済事業者ごとの差異を連携層で吸収し、経路と取引状態を共通の基準で管理します。
決済前ルーティングと承認後の障害迂回はどこで分かれるか?
マルチPGで最も危険な誤解は、「主力PGの呼び出しが失敗したらcatchブロックで補助PGを呼び出す」という実装です。決済フローは購入者認証より前(決済画面を開く前)とサーバー承認呼び出し以降(資金が動く段階)に分かれ、両区間の迂回可能条件はまったく異なります。[2][7]
決済画面を開く前であれば、PGの死活監視結果、カード会社のメンテナンス告知、決済手段、通貨、手数料率や重み付け規則に従って別のPGを自由に割り当てられます。一方、購入者がすでに特定PGの決済画面で認証を終えている場合、その認証トークンは別のPGでは承認できません。さらにサーバーが承認APIを呼び出した後にネットワークタイムアウトや 5xx 応答を受け取った場合、取引が実際に承認されたか拒否されたか分からない未確定状態になります。[3][4]
| 発生時点と状況 | 元取引の決済成立の可能性 | 別PGへの即時迂回の可否 | 安全な処理手順 |
|---|---|---|---|
| 決済画面呼び出し前のルーティング段階(保守告知・サーキットブレーカー開放) | なし(呼び出し前) | 可能 | 補助PGの決済画面とMIDで新しい決済試行を生成 |
| 購入者認証段階でのユーザーキャンセルまたは認証失敗 | なし(承認未呼び出し) | 可能(新しい決済試行へ転換) | 既存の試行を終了し、新しい試行として別PGの決済画面を提示 |
サーバー承認要求前のパラメータ・署名検証エラー(4xx の明確な拒否) | なし | 条件付き可能(入力修正または再認証が必要) | エラーコード確認後に再認証を誘導、同一認証トークンの再利用禁止 |
サーバー承認要求後の応答タイムアウト・接続断・5xx | あり(結果未確定) | 禁止(即時迂回は二重決済の危険) | 同一べき等キー・取引キーで元PGの状態照会または通信取消を確定後に判断 |
| 元PGへの照会結果で未承認または取消完了が確認された後 | なし(終了確認済み) | 可能(購入者の再認証が必要) | 既存の試行を失敗確定で閉じ、補助PGでの新規決済試行を案内 |
Toss PaymentsとStripeのべき等性ドキュメントはいずれも、ネットワークエラー時には同じべき等キー(Idempotency-Key)で同じ決済会社へ再要求するか、照会APIで結果を先に確認するよう案内しています。[3][5] べき等キーは同一PG内での重複承認を防ぐだけであり、自社サーバーが別のPGへ新規要求を送ることまでは防げません。
サーキットブレーカーは新規の決済画面進入のみを切り替える
連鎖障害を防ぐには、承認失敗率や応答遅延が閾値を超えた際にサーキットブレーカーが新規トラフィックのデフォルトPGを補助PGへ切り替える必要があります。[7] このとき切り替え対象となるのは新しく決済画面へ入る注文です。
すでに主力PGで認証を終えて承認待ちとなっている取引(CAPTURE_PENDING)は、サーキットブレーカーが開いたという理由で補助PGへ渡してはいけません。進行中だった取引は元PGの照会・取消パイプラインで最後まで決着させることで、2つの決済会社に同時に承認が残る事故を防げます。
定期決済の課金キーとカードトークンはなぜPG間で互換性がないのか?
通常の都度決済と異なり、定期決済(サブスクリプション課金)や簡単再決済では登録済みの課金キー(billingKey)や決済手段トークンを使って承認を要求します。多くのチームが「定期決済も主力PGが落ちたら補助PGで承認すればよいのではないか」と考えがちですが、一般のPGが発行した課金キーはそのPGと加盟店アカウント(MID)内でのみ有効な参照値です。
A決済会社で発行された課金キーをB決済会社の承認APIに渡しても、無効なキーとして拒否されます。カード番号の原文を自社サーバーで保持せずPGに委託してトークンだけを受け取る構造自体が、カードデータセキュリティ基準(PCI DSS)の保護範囲を縮小するための設計だからです。[1]
- 単一課金キー+時間差再試行モデル: PCI DSSの認証範囲を広げない大半のサービスは既存の課金キーで承認を要求しつつ、PGの一時障害時には別PGへ即座に移すのではなくバックオフ(backoff)再試行と請求猶予期間(grace period)で復旧を待ちます。
- 予備決済手段(Backup Payment Method)モデル: 顧客が主決済手段とは別に他社PGや簡単決済経路に紐づく補助決済手段を事前登録できるようにし、主経路が恒久拒否または長時間停止した際に事前告知された規則に従って補助手段へ請求します。
- 決済手段の再登録誘導モデル: 特定PGの契約終了や手数料構造の見直しで主力PGを恒久移転する際は、猶予期間中の更新タイミングを迎えた顧客へ新PGベースの決済手段変更を案内し、移転完了まで旧PGの更新・返金経路を維持します。
定期決済の状態遷移と再試行・猶予設計は定期決済APIをつなげばサブスクリプションサービスは完成するのかで詳しく扱っています。マルチPGを定期決済へ導入する際は「リアルタイム無停止の自動切り替え」を前提にするより、課金キーの帰属主体と再登録導線を先に確認する必要があります。
取消と部分返金はなぜ現在のルーティング規則に従ってはいけないのか?
決済承認の比率をA社PG 80%・B社PG 20%からB社PG 100%へ変更した日であっても、昨日A社PGで決済した顧客からの取消や部分返金要求は届き続けます。もし取消モジュールが「現在のデフォルトPG」設定を読んでB社PGへ取消APIを呼び出せば、元取引が存在しないというエラーですべての返金が止まります。
取消と部分返金はルーティングエンジンを経由せず、元の決済試行レコードに記録された pg_provider、merchant_id(MID)、pg_transaction_id へ直行しなければなりません。1つの注文を複数回にわたって部分取消する場合も、各取消試行は元決済試行の子レコードとして束ね、取消可能残高は元決済の承認額と累積取消額を基準に検算します。[2]
| 取消・返金シナリオ | ルーティング・帰属基準 | 検証すべき整合性条件 | 失敗時の保護装置 |
|---|---|---|---|
| ルーティング規則変更後の過去注文の全額取消 | 元決済試行のPG・MID・元取引キーを固定 | 元取引の状態が承認確定(CAPTURED)か確認 | 現在のルーティングテーブル参照を禁止 |
| 単一決済の複数回部分取消 | 元決済試行のPG+取消回次別の固有べき等キー | 累積取消額+今回の取消額 ≤ 元承認金額 | 割引額・送料の再計算後に残高不一致なら保留 |
| ポイント・クーポン・PG複合決済の部分取消 | 返金優先順位規則に従い内部控除分とPG取消分を分離 | PGへ送る現金返金額と内部復元額の合計一致 | 片方のみ反映された場合は補償待ち状態で隔離 |
| 承認直後の応答消失案件の通信取消 | 承認要求に使った同一PG・MID・元注文識別子 | 照会結果の承認有無に応じて取消または未承認を確定 | 通信取消の応答消失時は再照会キューへ移管 |
部分取消において割引・送料・課税/非課税金額がずれる計算問題は、部分取消で金額がずれる理由:割引・送料・返金を分けて設計するの原則にそのまま従います。マルチPG環境ではこれに加え、PGごとに異なる部分取消の制約(特定の簡単決済や旧契約における回数・期間制限など)をアダプターのメタデータとして併せて管理する必要があります。
注文から承認・返金まで状態を接続 — 決済手段を注文フローにつなぎ、応答遅延、再試行、取消し、返金の例外を検証します。
異なるWebhookと精算ファイルをどうやって1つの元帳に合わせるか?
PGごとにWebhookのイベント名、署名ヘッダー、タイムアウト、再送周期は異なります。Toss PaymentsはWebhook受信後10秒以内のHTTP 200 応答を求め、失敗時は最大7回再送します。一方Stripeはエンドポイント秘密鍵ベースの Stripe-Signature 検証と順不同到達の可能性を明記しています。[2][6]
Webhook受信器は、各PGアダプターが署名と送信元を検証した後に原本ペイロードを永続保存し、即座に 200 を返すよう構成します。実際の注文状態への反映は内部標準イベントへ変換したうえで共通の状態遷移規則を通過させ、遅れて届いた承認Webhookがすでに取消済みの注文を再び確定状態へ戻してしまう事故を防ぎます。
精算突合はPG原本を共通元帳スキーマへ正規化してから比較する
経理・財務チームが抱える最大の悩みは、PGが増えるほど精算ExcelやAPIの形式がばらばらになる点です。取引発生日基準で束ねるPGもあれば、売上確定日や入金予定日基準で束ねるPGもあり、消費税や手数料の端数四捨五入・切り捨て規則も異なります。
- 第1段階(原本収集): 各PGの精算APIやファイルを加工せず原本テーブルへ格納し、収集時刻とファイルハッシュを残します。
- 第2段階(共通スキーマ正規化): PGコード、MID、元取引キー、内部決済試行ID、取引区分(承認/取消)、総取引額、PG手数料、消費税、精算予定額、支払予定日に列を統一します。
- 第3段階(三者突合): 内部の注文・決済元帳、正規化されたPG精算元帳、実際の銀行入金明細を照合し、漏れ取引、手数料率の差異、入金保留案件を自動分類します。
突合基準と例外分類の設計は注文額・PG明細・入金額が異なるとき何を基準に突合するかおよび精算自動化資料で続けて確認できます。
本番前にどの切り替え・障害シナリオを試験すべきか?
マルチPGゲートウェイは正常な承認1件が通っただけで公開できるシステムではありません。本番移行前に隔離されたサンドボックス環境と障害注入(fault injection)テストで次の6つの境界を必ず検証する必要があります。
| 試験シナリオ | 注入する条件 | 合格判定基準 | 確認する証跡 |
|---|---|---|---|
| 決済画面進入前のPG切り替え | 主力PGのサーキットブレーカーを強制開放 | 新規注文が遅延なく補助PGの決済画面へ割り当てられる | 決済試行レコードのルーティング理由と補助PG MIDの記録 |
| 承認呼び出し中のタイムアウト | 主力PGの承認応答を設定時間以上に遅延させる | 補助PGへ自動迂回せず、未確定照会・通信取消キューへ入る | 同一注文で有効な承認取引が1件のみ存在することを確認 |
| ルーティング変更後の過去注文取消 | デフォルトPGをAからBへ変更後にA決済案件を部分取消 | 取消要求がA社PGの元MIDへ送信され正常に返金される | 取消試行の対象PG・元取引キーのマッピングログ |
| Webhookの重複・逆順受信 | 取消完了直後に過去の承認Webhookを再送 | 取消確定状態が過去の承認通知で上書きされない | Webhook受信記録と状態遷移拒否の監査ログ |
| 同一注文の連続失敗後の再試行 | A社PGで限度額超過拒否後、顧客がB社PGで再決済 | 試行1は失敗終了、試行2のみ承認確定し商品を1回提供 | 注文あたりの試行履歴2件と商品提供1件の一意性制約 |
| マルチPGの日次精算突合 | A・B両PGの承認・部分取消・手数料サンプルデータを投入 | 正規化元帳で件数・金額・手数料の差異を区別して検知 | PG別の突合結果表と不一致例外リスト |
連携前後に点検すべき必須項目はPG連携チェックリストで項目別に照らし合わせることができます。
決済会社の追加をサービス全体の改修へ広げないために
マルチPG導入の成否は、契約した決済会社の数よりも注文システムと決済代行会社の間にどれだけ堅牢な標準ゲートウェイ層を置いたかで決まります。決済試行識別子、承認前後の迂回境界、元取引ベースの取消帰属、正規化された精算元帳が定着すれば、新しいPGや簡単決済の追加はサービス全体の作り直しではなくアダプター1つの追加作業になります。
まずは現在運用中の決済テーブルで注文IDと決済試行IDが分離されているか、そして承認タイムアウトが発生した際にコードがどの分岐を通るかから確認してみてください。この2点を点検するだけでも、マルチPG移行時に起こり得る二重決済リスクの大半を事前に見極められます。
既存の単一PG構造からマルチPGゲートウェイへの移行や、決済承認・取消・精算突合パイプラインの整備を外部と共同で進める場合は、PG(決済代行)ゲートウェイ構築サービス、PG連携・決済システム構築サービス、精算自動化サービスでプロジェクト範囲をご相談いただけます。


