注文コールバックと重複提供の防止

2026-09-30 · 稳付pay · 決済導入ガイド

決済画面からの遷移は中断されることがあります。確実な決済確認には、サーバー側のコールバックと注文照会を組み合わせる必要があります。

非同期コールバックとは

決済結果が変わると、システムは加盟店が事前に設定したURLへ通知を送信します。この通知は注文状態の同期に使いますが、そのまま信用してはいけません。インターネットに公開するAPIでは、リクエストの送信元とデータの完全性を検証する必要があります。

署名検証と各項目の照合

サーバー側に保存した秘密鍵で署名を検証し、加盟店注文番号、実際の決済金額、決済状態、加盟店識別子も照合します。署名が正しくても、必ず商品を提供できるとは限りません。注文が存在し、完了処理を許可する状態であることを確認してください。

同じ注文を一度だけ処理する理由

タイムアウトによる再試行で、同じ通知が複数回届く場合があります。コールバックのたびに商品を提供したり、残高や売上を加算したりすると、業務データが水増しされます。一意の注文番号と最終状態を条件に更新してください。処理済みの注文には、取り決めた応答を返し、通知内容と時刻を記録します。

例外注文の調査方法

注文作成時のパラメーター、受信したコールバックの原文、署名検証結果、状態遷移、応答コードを保存します。サポート担当者や技術者が、注文番号から全体の流れを確認できるようにしてください。金額不一致、署名失敗、未登録の注文などは、自動で完了させず、手動確認の対象にします。

セキュリティ上の注意:秘密鍵はサーバー側だけで使用してください。ログには秘密鍵全体、利用者の機密情報、再送攻撃に使われる可能性がある署名情報を出力しないでください。

決済方法の選び方ガイドを読む