支付宝の処理済み通知が再送され続ける:応答仕様・プロキシ改変・収束確認
支払済みで会員権限も付与済みなのに通知が再送される場合、まず確定した業務記録を守り、応答経路を調べます。稳付payの代金回収通知と支付宝への直接接続では応答仕様が異なります。現行サイト文書に基づき、応答が受理されない問題を扱います。
テーマ別に読む
業務確定と通知受理の証拠を分ける
加盟店注文ごとに署名・金額の検証結果、支払記録のコミット時刻、重複判定結果、アプリの応答、エッジプロキシの応答を残します。ログは必要な識別子を伏せて記録し、秘密鍵や署名素材全体を残しません。アクセスログの200だけでは送信側が正しい本文を受理した証明になりません。
支払と権限付与が一度だけ記録されたか確認します。署名検証済みで既存事実と一致する再送は保存結果を再利用して応答します。加盟店、金額、通貨、状態が矛盾する場合は例外扱いにし、支払済みでも署名確認を省略しません。
実際に適用される応答仕様を照合する
現行の稳付pay文書はHTTP 200かつ本文にsuccess、ok、OKのいずれかを含む応答を受理し、プレーンテキストOKを推奨します。OKだけが許容されるわけではありません。他接続のJSON形式を無確認で流用せず、引用符、デバッグ出力、共通処理の最終出力を接続試験の合意と照合します。
ログイン転送、認証チャレンジ、ドメイン転送、エラーページ、プロキシキャッシュが通知経路に入っていないかも確認します。ブラウザで転送先が開けても通知サーバーが追従する証明にはなりません。許可された自社試験環境で実際の要求方式を使い、アプリ出力と最終応答の状態・本文・所要時間を比較します。
例:コミット済みでも応答が間に合わない
O-EXAMPLEは12:00:01に支払記録を確定した後、メール送信待ちで12:00:15に応答したとします。送信側は既にタイムアウトしている可能性があります。次の正しい通知では既存結果を返し、残高を再加算しません。遅いメール処理は復旧可能な後続作業とし、永続的な受領を応答境界にします。
別の例ではアプリがOKを返しても、ゲートウェイがJSONに包んだりエラーページに置換したりします。両段の証拠を残し、自社の経路やミドルウェアを修正して合成通知で検証します。保存失敗時に再送停止だけを目的として成功応答を返してはいけません。
履歴を消さず再送の収束を検証する
隔離した試験DBで署名付き合成通知を使い、初回、再送、矛盾、保存失敗、後続処理遅延を試します。支払事実は一件、再送による残高・権限増加なし、矛盾による改変なし、失敗前の成功応答なしを確認します。試験鍵を分け、本番の支払通知先へ送信しません。
現行文書では初回を含む最大3回で、最初の2回の失敗後に約60秒、300秒で再送します。無限再送ではありません。それ以上の要求は注文別、手動再配信、別送信元を関連記録で区別します。受理条件に疑問が残れば、伏せ字の時系列を元の担当者に渡して確認します。
よくある質問
会員付与後は再送を遮断できますか。
再送も検証して仕様どおり応答し、業務書込を一度だけにします。遮断すると送信側の失敗認識が続き、矛盾も見えなくなる可能性があります。
HTTP 200だけでは不足する理由は。
状態コードは応答の一部です。本文変換、通信の時間切れ、代理の別ページにより送信側の結果とアプリログが異なるため、経路全体の照合が必要です。