トランザクションの調査
DEUNA Adminで、注文の作成からルーティング、認証、決済、キャプチャ、キャンセル、返金までの状況を追跡します。
このページで
注文が保留、拒否、遅延、または商社との統合とは異なる状況にある場合に、トランザクションの状況を使用します。DEUNA Adminは、ビジネスレベルの決済履歴と、技術的なリクエストおよびレスポンスの記録を組み合わせることで、オペレーションおよび統合チームが同じトランザクションを、異なるツールを切り替えることなく調査できるようにします。
トランザクションの状況は読み取り専用です。イベントの表示は、リクエストの再試行、注文の変更、または決済プロセッサへの連絡をしません。
開始する前に#
あなたの役割には、以下のものが含まれます。 注文の閲覧 権限を確認してください。検索する前に、選択した商社と環境を確認してください。記録は、そのコンテキストに限定されます。
少なくとも1つの識別子を用意してください。
- 注文IDまたは注文トークン
- Transaction ID
- 顧客のメールアドレス（プライバシーポリシーに準拠）
- おおよその作成日
開けない場合は、 Payments > Orders, 管理者ユーザーにレビューを依頼してください 役割と権限.
適切なビューを選択#
注文の詳細を表示すると、調査のための2つの関連する表面が表示されます。まず、 履歴の表示、次に、 技術 が必要な場合は使用します。
| 表面 | こんな方に最適 | 表示される内容 |
|---|---|---|
| 履歴の表示 | 決済ライフサイクルの理解 | 注文の作成と更新、決済の作成とステータスの変更、ルーティング、3DS、および不正行為のイベント、それぞれに関連するフィールドとともに。 |
| 技術 | 統合またはプロバイダとのやり取りの診断 | 記録されたトランザクションイベント、HTTPメソッドと宛先、レスポンスコード、リクエストとレスポンスデータ、タイムスタンプ、および利用可能なリクエスト、トレース、およびスパン識別子。 |
| アクティビティログ | Adminユーザーによる操作の監査 | 誰が設定を変更したか、またはAdmin操作を実行したか。アクティビティログは、決済の実行履歴を反映していません。 |
トランザクションの活動へのアクセス#
- DEUNA Adminにサインインします。
- トランザクションに関連する商社と環境を選択します。
- 開きます Payments > Orders.
- 注文IDまたはメールアドレスで検索するか、日付と決済フィルターを使用してリストを絞り込みます。
- 行アクションメニューを開き、選択してください 詳細を表示.
- ライフサイクル概要の選択 履歴の表示. 取引に関する詳細については、こちらをご覧ください。 技術.
注文に記録された技術イベントがない場合 技術 表示する 技術的な活動がない. これだけでは、問題の原因や決済の結果を特定することはできません。
決済履歴を追跡する#
選択 履歴の表示 注文の詳細ヘッダーから。履歴は、最新の記録から順にタイムラインとして表示されます。
正確なフィールドはイベントによって異なります。
| イベント | 期待できる証拠 |
|---|---|
| 注文の作成 | 初期金額、通貨、および注文ステータス。 |
| 注文の更新 | 現在の注文と決済ステータス。 |
| 決済の作成 | 決済金額と通貨。 |
| 決済ステータスの更新 | 決済ステータスと適用されるプロセッサ、承認、キャプチャ、返金、またはエラーの詳細。 |
| ルーティングが生成された | 適用されたルールとパス、およびそのルートによって表される決済または不正行為プロバイダ。ルーティングの決定は、複数のタイムラインエントリを作成する可能性があります。 |
| 3DSが更新されました | 認証ステータス、3DSプロバイダー、およびエラーコードまたはメッセージ（発生した場合）。 |
| 不正行為分析 | 利用可能なプロバイダー、決定、リスク、評価、またはシャドウモードの詳細。 |
中間イベントを最終的な財務結果として解釈しないでください。たとえば、3DS認証が成功した場合、決済処理は継続しますが、決済が承認または実行されたことを意味するわけではありません。
技術イベントの調査#
開きます 技術このビューには、以下の2つの領域があります： アクティビティ および データ.
DEUNA Admin の技術アクティビティ。この例に含まれる加盟店、ユーザー、プロバイダー、識別子、時間、ペイロードの値はすべて架空です。
技術ビューの内容
| エリア | そこに表示されるもの | 使い方 |
|---|---|---|
| 注文コンテキスト | 注文合計、注文および支払いステータス、最終更新、注文トークン、注文ID、および顧客ID。 | イベントを解釈する前に、正しい注文と環境が開いていることを確認してください。 |
| アクティビティ制御 | イベントの記録数、ソート制御、イベント名の検索、および「なし」「リクエスト」「トレース」の3つのグループモード。 | 調査中の操作に関連するイベントのみを、長いトランザクション履歴から抽出します。 |
| グループヘッダー | グループタイプ、短縮されたリクエストIDまたはトレースID、イベント数、およびそのグループ内のイベントの記録された実行時間の合計。 | 関連するチェックポイントを展開または折りたたんで、1つのリクエストまたはトレースを別のものと比較します。 |
| アクティビティチェックポイント | 利用可能な場合は、レスポンスコードバッジ、イベント名、イベント作成時間、および記録されたログタイムスタンプ。 | 失敗、遅延、または予期しない段階に最も一致するチェックポイントを選択します。 |
| 交換概要 | HTTPまたはプロトコルメソッド、宛先、リクエストID、トレースID、およびスパンID。 利用可能な識別子はコピーコントロールを含みます。 | イベントを、商社ログ、プロバイダの証拠、またはDEUNAサポートの調査と関連付けます。 |
| データビューア | リクエストとレスポンスのタブ、レスポンスコードの表示、利用可能な場合に経過時間、およびフォーマットされたペイロードデータとコピー機能。 | 送信されたデータと返された結果を比較します。 必要な最小限の安全な証拠のみをコピーします。 |
ペイロードビューアは、オブジェクトとフィールド名を表示し、交換の形状を検査できるようにします。 値とネストはイベントとプロバイダによって異なります。 例に示すフィールドは、すべてのトランザクションで表示されることを保証するものではありません。
イベントを読み取る
- イベントを選択してください。 アクティビティ（モバイルの場合は）イベントを拡大します。
- イベント名とタイムスタンプを確認してください。
- HTTPメソッド、宛先、およびレスポンスコードを確認し、期待する操作と比較してください。
- 以下のいずれかの方法で切り替えます。 要求 および 応答 を返します データ.
- Request ID、Trace ID、またはSpan IDが利用可能な場合は、記録してください。
イベントに 4xx がある場合、DEUNA Adminは、ペイロードの上部に エラーメッセージ を表示できます。その他のレスポンスコードは、イベントとデータパネルで引き続き表示されます。
レスポンスコードは、必ずしも最終的な決済結果を意味するものではありません。注文の処理を行う前に、コードを 支払いステータス, 履歴の表示と、非同期のステータス通知と比較してください。
注文処理中に発生するイベント
利用可能なアクティビティは、トランザクションの経路によって異なります。一般的なグループには以下が含まれます:
| 段階 | アクティビティで表示される例 | 検査対象 |
|---|---|---|
| 注文 | 新しい注文が作成されました。注文が更新されました | 注文識別子とステータスが、商社への統合に返されます。 |
| ルーティング | 決済経路の生成 | 選択されたパスと、それに続くプロバイダーとの間で交換されるデータ。 |
| 決済 | 決済の生成、および承認の要求 | 決済金額と通貨、プロセッサからの応答、および結果の決済ステータスの取得。 |
| 認証 | 3DSの評価（開始、挑戦、更新、完了、失敗） | 顧客の介入が必要かどうか、および決済処理がその後継続するかどうか。 |
| 住所検証 | AVSの検証、抑制、または取り消し | 正規化された検証結果と、それに続く決済アクション。 |
| 不正行為 | 不正検知エンジンの分析、および影での評価の生成 | プロバイダーの結果と、トランザクションが決済処理またはレビューに進むかどうか。 |
| 決済後の操作 | 決済、部分決済、払い戻し、部分払い戻し、キャンセル、または取り消しリクエスト | オペレーションの金額と識別子、応答、および結果を確認する後の決済ステータスイベント。 |
一部のイベントは、ステージが完了したことを記録しますが、リクエストまたは応答の本文を含みません。ペイロードの可用性は、オペレーションとプロバイダーによって異なります。
トレースのグループ化と検索#
「 アクティビティ以下のコントロールを使用して、長いログを短縮できます。
- なし 各イベントを平坦なリストで表示します。
- 要求 リクエストIDで同じイベントをグループ化します。これにより、1つのインバウンドリクエストによって開始された処理を追跡できます。
- トレース トレースIDで同じイベントをグループ化します。これにより、関連する処理ステップ全体を横断するトランザクションを追跡できます。
- イベントの検索 表示されているイベント名でフィルタリングします。
- アクティビティのソート イベントの順序を逆転します。
イベントに、選択したグループ識別子に対応する値がない場合、DEUNA Adminはそれを 孤立に配置します。イベントは、トランザクションID、タイムスタンプ、および隣接するイベントがインシデントウィンドウと一致する場合に、依然として有用です。
失敗または遅延した支払い調査#
以下の手順に従い、中間的な技術的なエラーを最終的な結果と誤認しないようにしてください：
- 環境、現在の注文ステータス、現在の決済ステータスを確認してください。 Order ID, および Transaction ID.
- 開きます 履歴の表示 および最後のライフサイクルイベントを特定してください。
- 開きます 技術 および、 トレース.
- 照合する支払い、ルーティング、認証、不正行為、または支払い後のイベントを見つけてください。
- そのレスポンスコードとレスポンスデータを、トレース内の次のイベントと比較してください。
- 支払いステータスが更新され、別のプロバイダーに移動されたか、最終的な失敗が確認されたかを確認してください。
- 最終的なDEUNAのステータスと、 ご自身の支払いwebhookで受信したステータスを比較してください。.
拒否の場合、公開の エラーコード参照 DEUNAのエラーコードの使用。プロバイダー固有のコードとメッセージは、関連するプロバイダーのドキュメントを参照して解釈してください。
サポートに必要な証拠の準備#
DEUNAサポートによる調査が必要な場合、以下の最小限の証拠をご提供ください：
- 事業者および環境
- 注文IDまたは注文トークン
- Transaction ID
- UTCタイムスタンプとインシデント発生時間
- 表示されるイベント名とレスポンスコード
- 利用可能な場合、リクエストID、トレースID、およびスパンID
- 現在の注文と支払いステータス
- 期待される動作と実際の動作
サポートが必要な場合のみ、完全な生のペイロードを送信してください。
制限と復旧#
- トランザクションアクティビティは、再実行またはリトライ制御ではなく、オブザーバビリティ記録です。
- すべての段階でリクエストとレスポンスのボディが生成されるわけではありません。
- プロバイダが非同期の結果を報告した場合、イベントは初期リクエスト後に到着する場合があります。
- アクティビティが欠落している場合、プロバイダがトランザクションを処理したかどうかは判断できません。
- 現在の支払いまたは注文ステータスは、管理者の authoritative なスナップショットです。統合側のステータス管理には、ウェブフックと関連するAPIレスポンスを使用してください。
識別子と環境が正しいにもかかわらず、必要なイベントが欠落している場合は、上記の証拠を収集し、DEUNAサポートにお問い合わせください。トランザクションを再試行する前に、それが安全であることを確認してください。