決済署名キーの更新時に未完了注文をどう扱うか:切替条件・通知検証・再照合

署名キー更新後に旧注文の通知が届いても、作成時刻だけでは使用キーを決められません。検証失敗も支払失敗の証明ではありません。実際の切替規則を技術担当と確認してから設定を変更します。加盟店側の運用設計であり、稳付payに二重キーやバージョン項目があるとする説明ではありません。

テーマ別に読む

1.通信方向ごとに規則を確定する

注文作成、照会、通知について、認証仕様、加盟店、環境、有効境界と担当者を分けて整理します。要求用キーが後の通知にも使われるとは限りません。送信時設定か注文時設定かなど、実際の規則を確認します。

未完了注文と再送され得る通知を洗い出し、元注文番号、作成時刻、確認済み支払結果、通知処理、照合方法を記録します。内部設定ラベルを勝手にAPI項目や署名対象へ追加しません。

2.新設定を準備し、移行範囲を限定する

合意した安全な経路で新キーを受け取り、自社の模擬データで文字コードと実際の署名仕様を確認します。ログは設定ラベル、結果、関連番号に限り、キーや署名元データ、再利用可能な認証情報を残しません。

併用は接続先が明確に対応する場合だけです。対象メッセージ、期限、旧設定削除を決めます。失敗のたびに全旧キーを試したり、検証なしで提供したりしません。併用不明なら影響通知の照合手順を先に合意します。

3.遅延通知と重複を模擬する

切替前の模擬注文Aと切替後のBを用意し、Aの通知を遅らせ、Bを二重配送します。合意規則で設定を選び、送信元、加盟店、元注文、金額、通貨、成功状態を確かめます。秘密を記録せず使用版と結果を残します。

Aの検証失敗は要確認とし、入金、返金、未払いを断定しません。合意された信頼できる照会や技術調査を使います。照会と通知は同じ冪等記帳へ集約し、Bの提供は一回だけです。AとBは内部例です。

4.漏えい疑いは通常更新と分ける

通常更新は合意済み移行期間で終えられますが、漏えい疑いでは旧キーへの信頼を止め、自動提供を制限し、信頼を再確立した経路で対象期間を調査します。漏れたキーで検証できても真正性の十分な証拠にはなりません。

未解決注文の証拠、旧設定の廃止、失敗理由を確認して終了します。アプリのロールバックで失効キーを復活させません。環境違い、未知の版、金額不一致、設定配布失敗、DB確定失敗も模擬し、不明事項に担当と次の手順を付けます。

よくある質問

注文作成時刻でキーを決められますか。

実際の仕様がその対応を定義する場合だけです。通知署名の規則を確認し、時刻の近さを認証根拠にしません。

検証失敗時は再度支払ってもらいますか。

元注文を先に照合します。既払い注文の二重払いを避け、信頼できる確認と記帳が終わるまで要確認を維持します。

参考資料