決済運用とセキュリティ

決済ログの残し方:注文調査とコールバックの機密情報除去ガイド

利用者は支払い済みと言うのに、サイトの残高が増えていない。最初にどの記録を確認すればよいでしょうか。関連付け・照合・機密情報除去ができたログがあれば、運営者と技術担当者が同じ注文を追跡できます。本記事は加盟店側の実装例であり、例示した項目は稳付payのAPI仕様ではありません。ログ画像だけで支払いを証明するものでもありません。

この記事の目次

1. 支払い・コールバック・残高反映・精算を分ける

チャージ処理には、支払いの確認、通知の到達、署名検証、残高の台帳反映、精算完了という別々の状態があります。コールバックへの成功応答だけでは残高反映を証明できず、残高が増えていても加盟店への精算完了を示すとは限りません。「成功」という一つの表示で後段の失敗が隠れないよう、事実を個別に記録します。

稳付payのWeChat・Alipay代収とUSDTオンチェーン監視では資金経路が異なります。代収後のUSDT精算は加盟店との取り決めに従います。オンチェーン監視では顧客が加盟店自身のウォレットに直接送金し、プラットフォームは資金を受領・保管しません。現在の対応ネットワークはTron(TRC20)とEthereum(ERC20)で、設定した確認条件を満たしてから通知します。両者を同じ入金イベントとして扱わないでください。

2. 注文番号で処理全体をつなぐ

加盟店内部の注文番号を軸に、プラットフォーム注文番号、内部リクエストID、通知試行記録、台帳明細IDを関連付けます。一つの注文には複数のリクエストや重複通知があり得るため、通知のたびに新規注文を作ってはいけません。サービス間の関連付けにはランダムな追跡IDを利用できますが、メールアドレス・電話番号・実際のユーザーIDを埋め込まず、認証情報としても扱いません。

オンチェーン記録にはネットワーク、資産、取引ハッシュ、送金を特定するために必要なイベント情報も残します。一つの取引に複数の送金イベントがある場合、ハッシュだけでは区別できないことがあります。金額には通貨と単位を付け、法定通貨とUSDT数量を分けて、整数の最小単位または正確な十進数で保存します。アドレス自体は公開情報でも、利用者の注文と結び付けた情報の共有範囲は制限します。

3. リクエストの丸ごと保存ではなく時系列を記録する

各イベントには発生時刻、受信時刻、注文参照、処理段階、結果、所要時間、選別したエラー分類を記録できます。タイムゾーン付きの時刻形式に統一し、サーバー時計も確認します。非同期処理が遅れて実行された場合は両方の時刻を残します。次の例は加盟店が独自に定義するログ形式で、項目名・イベント名・状態はプラットフォームのAPI仕様ではありません。

{
  "occurred_at": "2026-10-22T09:15:00+07:00",
  "order_ref": "DEMO-ORDER-001",
  "request_ref": "DEMO-REQUEST-001",
  "event": "callback_authentication",
  "result": "verified",
  "duration_ms": 12,
  "environment": "example_only"
}

注文作成、支払い状態照合、通知受信、認証結果、台帳コミット、サービス提供の順に確認します。HTTP応答コードと所定の応答が一致したかを残し、応答本文・ヘッダー・署名値を丸ごと出力しません。タイムアウトは結果要確認として扱い、支払い失敗と即断しないでください。ログ書き込みエラーによって再課金や残高の二重加算が起きない構成にします。

4. ログを書き込む前に機密情報を除去する

調査に必要な項目だけを許可リストで選びます。API秘密鍵、パスワード、Cookie、Authorization、署名値、ウォレット秘密鍵、シードフレーズは通常ログに残しません。通知URLのクエリ中のトークン、メールアドレス、電話番号、利用者の自由記述も除去します。全内容を保存してから画像にモザイクをかけても、収集基盤やバックアップに原文が残っている可能性があります。

外部入力の長さを制限し、改行・制御文字・信頼できない文字列を処理して、備考が別のログ行を偽装できないようにします。署名検証には仕様で定める元データを使い、機密情報除去済みのログ用コピーで代用しません。追加の診断証拠を保存する場合は、公開ダウンロード領域を避け、専用のアクセス制限・監査・削除期限を設けます。

まず加盟店注文、通貨、金額、現時点で検証できる支払い状態を照合し、通知が正しい環境へ到達したかを調べます。次に認証、金額照合、状態遷移、台帳トランザクションのコミットを確認します。重複通知で受信記録が複数になっても、同じ業務処理による有効な台帳変動は一件に抑えます。重複抑止は説明可能な結果として記録し、再加算しません。

オンチェーン取引を検出しても設定済みの確認条件に達していなければ、確認待ちを維持します。確認完了後は注文照合、通知、加盟店側の残高反映を調べます。画面遷移や一枚の画像だけで手動加算してはいけません。調整が必要な場合は独立した照合、権限のある訂正手順、理由・承認者・調整明細の記録を伴わせ、遅れて届く通知による二重加算も防ぎます。

6. 技術担当者へ送る最小限の調査資料

対象注文の参照、発生時刻とタイムゾーン、決済方法またはネットワーク、期待結果、実際の症状、前後の機密情報除去済みイベントをまとめます。完全な注文参照が必要なら、確認済みの技術窓口へ非公開で共有し、公開画像や質問では代替IDを使います。管理画面の認証情報、設定ファイル一式、秘密鍵、データベース全体は送らないでください。

再試行、チャネル切り替え、手動処理の有無と、自動処理が現在も続いているかも記載します。支払い側、通知経路、加盟店台帳のどこを調べるべきか判断しやすくなります。稳付payの認証・応答・再試行規則は各サービスの確認済み文書を利用し、WeChat・Alipay代収の仕様をUSDT監視へ流用しないでください。

7. 保存期間・アクセス権・公開前確認

用途と適用要件に応じて保存期間を決め、運用ログと正式な取引台帳を分けます。ログ削除によって保存すべき会計記録を失わないようにします。閲覧・出力を制限し、アクセス監査と保存・通信の保護を行い、ログを公開Web領域に置きません。ローテーションと容量警告を設定し、空き容量不足が決済処理や重要な会計イベントに影響しないか確認します。

公開前にデモデータで通常通知、重複、認証失敗、タイムアウト、台帳コミット失敗を確認し、情報漏えいなく原因を特定できるか検証します。これは加盟店実装のログと業務処理の確認であり、実決済APIの呼び出しや公開サンドボックスの存在を前提としません。接続試験の接続先・権限・方法は事前に技術担当者へ確認してください。

8. よくある質問

HTTP 200ならチャージ完了と判断できますか?

いいえ。HTTP状態、所定の応答、署名検証、台帳コミットは別々の証拠です。対象APIの仕様と加盟店台帳を確認し、通信成功を残高反映と同一視しないでください。

調査のため完全な通知内容をグループへ送れますか?

避けてください。必要な項目だけを抽出して機密情報を除去し、確認済みの窓口で共有します。秘密情報がログに残った場合は直ちにアクセスを制限し、技術担当者と鍵の更新や複製の処理を進めます。画像一枚の削除だけでは不十分です。

ログが確認済みでも台帳を照合するのはなぜですか?

ログは処理過程を示し、台帳は正式な残高変動を記録します。オンチェーン確認後も通知、注文照合、データベースのコミットが失敗する可能性があります。処理全体を照合し、再照会や通知の再処理で二重加算されないようにします。

参考資料

ログのセキュリティはOWASP、サービス間の追跡IDはW3Cを参考にしています。本記事の項目と調査手順は加盟店側の実装提案です。実際の決済仕様は接続時に確認した文書に従ってください。

事業の内容に合わせて導入を確認

商品、注文量、決済方法、精算要件を伝え、インターフェース、資金の流れ、例外処理を一つずつ確認します。

稳付payに問い合わせる ↗