決済API文書の更新時にどう移行するか:項目互換性・署名検証・旧注文の確認
正式開設後の資料に項目追加や例変更があっても、コードと設定をそのまま上書きしません。文書版、加盟店で有効な設定、アプリ版、未完了注文をまとめて確認します。本稿は移行管理であり、稳付payの固定版項目、二版API、互換期間を約束しません。
テーマ別に読む
差分と実適用範囲を先に整理する
新旧資料の日時・版参照を保存し、経路、方法、項目名・型、必須性、金額単位、列挙、署名、応答を比較します。追加項目の署名参加も確認し、任意だから無影響とは考えません。
対象加盟店、チャネル、環境、適用時刻、旧注文の照会・通知を担当者に確認します。例の文言変更が契約変更とは限らず、項目名不変でも意味は変わり得ます。文字置換だけで移行しません。
構造検証と業務検証を分ける
OpenAPI等はHTTP構造を記述できますが、構造適合だけでは署名、金額、帰属、提供を証明できません。プラットフォームのOpenAPI公開を仮定せず加盟店独自の契約表を管理できます。
機密除去した例で欠落、追加、空値、数値型、未知列挙を検証します。旧クライアントの追加情報対応は契約で確認し、未知全無視や項目追加ごとに有効通知全拒否といった一律処理をしません。
旧注文の解析境界を明確にする
旧設定でOLD-Aを作成し新設定適用後に完了した例では、元設定と双方が確認した通知契約を調べます。受信時刻だけで新版と判断せず、通るまで署名規則を順番に試しません。
設定参照、適用境界、注文関連を残し、実鍵をスナップショットや報告へ入れません。旧鍵・処理器の廃止、未決確認は技術担当へ確認します。移行で支払済み・提供済みの事実を消しません。
実行可能な公開と切戻し確認で終える
新注文、旧未決、通知・照会、再通知、未知状態、入帳失敗、切戻しを検証します。HTTP成功画像一枚ではなく期待・実結果・責任者を残し、未検証は未受入として明示します。
稳付payと正式資料と切替を確認後に公開します。非互換時は対象の新操作を制限し証拠を残して合意どおり戻します。戻したコードも新版で既に作った注文を引き継ぎます。返金・出金等の開放は別確認であり、文書に語があるだけで対応済みと推測しません。
よくある質問
任意項目追加なら旧システムは安全ですか?
必ずしもそうではありません。署名・検証・意味に影響し得るため適用範囲を確認し新旧例を再試験します。
受信日で署名版を選べますか?
それだけでは不足です。旧注文の通知は切替後にも届くため、元設定と契約境界を使い不明は担当者に確認します。