リソース · 47

不確実な支払い:重複注文なしでチェックアウトを回復する

単一のシグナルのみを十分なものとして扱うのではなく、ネットワーク遅延、ブラウザからの戻り値、通知、およびビジネス状態を調整します。

更新済み · 6 min

真ちゅうのブロック3個、目盛りのない文字盤、用紙、えんじ色の資料がある架空の無人分析室 AIで生成した編集用イラスト

このガイドが達成するのに役立つこと

  • 試行、支払い、注文を分離する
  • 遅延または未着の返品を処理する
  • 通知とリクエストの重複を排除する
  • ユーザーに再度支払いを求めることなく、不確実性を説明する

クイックチェック

  • どのソースが支払いを確認するのか?
  • ブラウザを閉じるとビジネス状態は変化するのか?
  • 繰り返し発生するイベントは2つの注文を準備するのか?
  • イベント署名はチェックされるのか?
  • サポートはどのようにして不確実な操作を検出するのか?

手順

  1. 1

    状態を定義する

    カート、試行、承認、支払い確認、注文、返金を個別に管理する。 遷移、権限のあるソース、許可されたアクションを記述する。 実際のプロバイダーと支払い方法に従う。 すべての方法が即座に確認できるとは限らない。

    成果物:状態図とビジネス契約。

  2. 2

    操作を識別する。

    試行を注文とプロバイダー識別子に関連付ける。 同じ操作を繰り返す場合は、文書化された冪等性ルールを使用する。 新しい目的や変更されたパラメータの場合は、盲目的なキーの再利用ではなく、明示的な判断が必要となる。 ​​

    成果物:安定したIDと回復ルール。

  3. 3

    ブラウザの戻りを処理する。

    プロバイダーに適したサーバー側チェックからの状態を表示する。 成功ページへのリダイレクトだけでは支払いの証拠とはならない。 ブラウザが閉じられた場合、戻りがなかった場合、認証が中断された場合、ネットワークが遅い場合に対応する。

    成果物:状態ごとの戻り経路とメッセージ。

  4. 4

    通知の検証

    プロバイダーのドキュメントに従って真正性を確認し、イベントIDを記録し、重複効果なしで繰り返し処理を行います。 イベントは遅延したり、順序がずれたりする場合があります。 必要に応じて、不可逆的な遷移の前に参照オブジェクトを取得します。

    成果物:テスト済みのハンドラーと銀行データを含まないトレース。

  5. 5

    不一致の調整

    プロバイダーの操作、注文、および履行を比較します。 注文なしの支払い、確認なしの注文、二重処理、および未伝播の払い戻しを分離します。 各不一致に所有者と手順を割り当て、不確実な請求を自動的に繰り返さないようにします。

    成果物:調整キューと決定。

  6. 6

    完全復旧のテスト

    プロバイダーのテストモードで、タイムアウト、重複、遅延イベント、逆注文、および未返却を再生します。 1つのビジネス遷移、正しい顧客情報、およびサポートの可視性を確認します。 冪等性の詳細はプロバイダーによって異なります。

    成果物:重複排除の証拠および導入基準。

架空の事例

具体的な状況

例:支払いは成功しましたが、顧客が確認前に接続を失い、その後2つの通知が届きました。

決定と期待される証拠

1つの注文が確認されました。 リカバリでは検証済み状態が表示され、サポートは銀行口座の詳細を要求することなく参照情報を照合できます。

メカニズムの区別

メカニズム目的検証または制限
ブラウザの戻りインターフェースの通知と再開欠落または中断される可能性がある
検証済みウェブフックプロバイダの状態変更を受信繰り返し、遅延、または順序が乱れる可能性がある
サーバー調整支払いと注文の状態を比較不一致解決ルールが必要

管理指標

指標測定対象最初のアクション
不確実な状態意図した遅延時間内に解決されない操作参照状態を確認
重複効果注文または処理が二重に実行されたビジネス重複排除を修正
ギャップを解消決定と証拠に基づいて調整されたケース最も古いケースと重要なケースを処理

よくある間違い

  • 成功URLのみからの確認
  • タイムアウトを支払い失敗として扱う
  • イベントの想定 順番通りに届く
  • 確認前に請求を繰り返す

よくある質問

タイムアウトは失敗を意味しますか?

いいえ。遅延時間内に応答が受信されなかったことを意味します。 別の操作を作成する前に、操作の状態を確認してください。

プロバイダの冪等性は十分ですか?

いいえ。注文の作成、履行、通知は、重複したビジネス効果なしに繰り返し処理を許容する必要があります。

ユーザーには何を伝えるべきですか?

検証が進行中であることを説明し、安全な参照情報とステータスを取得する方法を提供します。 前回の支払いが不確実な間は、別の支払いを要求しないでください。

有用な検証のためにどの証拠を残しますか?

機密でない識別子、状態、業務上の作用が一度だけだった証拠を残します。再試行はタイムアウトだけでなくAPI契約に基づけます。

Webhook:署名と再送

この言語版の詳しい参照メモは英語で提供しています。

A payment notification does not close reconciliation by itself

Authenticate each webhook, bind it to the right account and compare its effect with authorised server state. A repeated event must not repeat an initial activation; missing events must remain detectable.

  • Separate notification identity from the operation to perform.
  • Test overlapping manual resend and automatic retry.
  • Retain uncertainty after an unknown external result and check the source before retrying.

See webhook signatures, digests and the ten cases →

Sources reviewed on · Stripe · Webhooks · Stripe · Manage webhook endpoints · GitHub · Validating webhook deliveries · GitHub · Best practices for using webhooks · GitHub · Handling failed webhook deliveries

API金額の精度と正確な単位

この言語版の詳しい参照メモは英語で提供しています。

Separate exact conversion from payment confirmation

An interface can display the correct price while preparing an incorrect provider integer. Acceptance must reconcile the server amount with the operation contract, then check confirmed state without mistaking arithmetic for completed payment.

  • Test zero-, two- and three-decimal currencies.
  • Include a case where step cannot be inferred from decimals.
  • Retain an exact reference before localised formatting.

Check a unit in the workshop →

Adyen · Currency codes and minor units · Provider documentation · reviewed 2026-11-06

Stripe · Supported currencies and special cases · Provider documentation · reviewed 2026-11-06

公式参照文献

参照文献はメソッドを裏付けるものです。 チェックは状況に合わせて調整してください。 これらは認証ではありません。 元の参照文献のタイトルやソース文書は別の言語で書かれている場合があります。

参照資料の確認日 .