決済コールバックURLの移行:旧注文・証明書・切替の確認

ドメインやプロキシを変えた際、トップページの表示だけでは決済通知の到達を確認できません。変更が新規注文だけに適用されるか、既存注文にも及ぶかを技術担当に確認します。複数の通知URLを同時設定できるという機能説明ではありません。

テーマ別に読む

未完了注文と旧URLを先に整理する

旧ホスト、通知の完全なパス、HTTPメソッド、証明書の期限、受信アプリを記録し、最終結果が未確認の注文を一覧にします。鍵や署名全文は記録しません。送信先が注文作成時に固定されるか、送信時の設定から選ばれるか、再試行期限と照会方法を担当者に確認します。

旧URLを保存した注文は設定変更後も旧入口を必要とする場合があります。送信先の扱いが不明なら、旧ドメインや証明書を先に廃止しません。

リダイレクトに頼らず受信経路を調べる

DNS、TLS、プロキシの経路、アプリログの順に確認します。CDN利用時は端末からエッジ、エッジからオリジンの証明書を分けて確認し、検証を無効にしません。疎通確認は自社の副作用のないヘルスチェックURLで行います。

307は追従時にメソッドと本文を維持しますが、実際の通知クライアントが追従する証明にはなりません。技術担当と直接到達できる最終URLを確認し、ログイン画面やブラウザー認証画面への転送を避けます。

二つの入口を同じ注文記録へ結ぶ

合意した併存期間には、永続化された同一の注文・重複防止記録を使います。各通知は実際の仕様で署名、注文、金額を確認してから提供処理を行い、移行を理由に検証を省略しません。メモリーだけの処理済みフラグでは別サーバーに共有できません。

例として旧注文O-OLDは旧入口、新注文O-NEWは新入口で受信します。O-OLDの再通知が別の内部経路を通っても既存の提供記録に結び、再提供しません。注文名は説明用であり、稳付payの項目名ではありません。応答と再試行は適用仕様に従います。

証拠に基づいて切戻しと廃止を判断する

アクセスログがなければDNSや証明書、プロキシを確認し、アクセスはあるがアプリ記録がなければ経路や本文読取を確認します。署名不一致は元の項目、文字コード、環境設定を調べ、手動で成功扱いにしません。不明注文は許可された照会手順で確認します。

切替時刻、設定版、匿名化した注文対応表と責任者を残します。旧注文の遅延、新通知、重複、証明書不良、アプリ異常を検証し、切戻しが既存注文に及ぼす範囲も確認します。旧入口の廃止日は未完了注文と合意した再試行範囲から決めます。

よくある質問

旧ドメインを301転送すれば十分ですか。

いいえ。通知側の追従とリクエスト保持を確認し、旧注文と再試行条件に応じて旧入口を維持します。

CNY代金収納の応答規則をUSDTに使えますか。

使えません。USDTの通知項目、検証、応答は専任技術担当に確認し、既存CNY文書を流用しないでください。

参考資料