メインコンテンツへスキップ
すべてのシステムが正常に動作しています変更履歴v1
ログイン

APMルーティング

このページで

APMルーティングを使用すると、高度なルールに基づいて、適切な代替支払い方法（APM）アカウントにトランザクションを自動的にルーティングできます。

現在のサポート状況 APMルーティングは、サポートされているウォレットおよび銀行振込フローで利用可能です。バウチャー、BNPL、現金、POS、および参照決済フローは、この機能でルーティングされません。利用可能性は、APM接続と設定されたルールによって異なります。

インタラクティブな例サンプルデータを使用し、APIリクエストは行いません。
本番環境
決済方法

APM ルーティング

決済コンテキストに一致するプロバイダー認証情報を選択します。

Acme LATAM · 本番環境
設定APM ルーティング
アクティブ
プロバイダー認証情報
ルーティングPayPal · USD primary

APMルーティングとは？#

APMルーティングは、同じAPMプロバイダーで複数のアカウントを使用する商取引にとって不可欠です。これは、通常、通貨、国、またはトランザクション金額で分割されます。

MXNとUSDの両方でPayPalのトランザクションを処理している場合、通常は通貨ごとに異なるPayPalアカウントを使用しています。 APMルーティングは、手動での介入なしに、各トランザクションが自動的に正しいアカウントを使用するようにします。

仕組み#

顧客がトランザクションを開始すると、DEUNAのルーティングエンジンは、リアルタイムで設定されたルールを評価し、トランザクションのコンテキスト（通貨、国、金額）に基づいて適切なAPM認証情報を選択します。

この選択は、以下のすべての重要なタッチポイントで自動的に行われます。

  • 支払い方法の取得 (GET /payment-methods) — フロントエンドの初期化に必要な情報を返します
  • 同意フロー (/consent— 正しいアカウントの選択を保証
  • 最終的な支払い処理 — トランザクションを対応するアカウントにルーティング

システムは優先度に基づいた解決策を採用します。まず、特定のルールが評価され、その後、ルールに一致しない場合に、デフォルト設定が適用されます。

APM のルーティングの設定#

DEUNA Admin で APM のルーティングの設定は簡単です：

ステップ 1: APM の認証情報を接続

  1. DEUNA Admin にログインします。
  2. 以下のパスに移動する 支払い方法.
  3. 最初の APM の認証情報を接続します。
    • 自動的にあなたの デフォルト credential.
    • デフォルトの支払い戦略が自動的に作成されます。
  4. 同じ APM に対して、必要な追加の認証情報を追加します。

ステップ2：ルーティングルールの作成

  1. 以下のパスに移動する 戦略.
  2. クリックしてください APM tab.
  3. クリック 新しいルールを作成する.
  4. ルーティング条件を定義する:
    • 通貨: 取引通貨に基づくルーティング。
    • 国: 取引が発生する国。
    • Amount: 取引金額に基づくルーティング。
  5. マッチングする取引を処理するAPMの認証情報を選択する。
  6. ルーティングルールの名前を定義する
  7. 優先順位を設定する。
  8. ルールを保存

利用可能なルール条件:

  • 通貨
  • 国
  • Amount

複数の条件を単一のルールに組み合わせるには、AND論理を使用できます。例：「通貨 = USD AND 国 = US AND 金額 > 100」

ステップ 3: ルールの優先順位を管理する

ルールは、最も高い優先順位から順に評価されます。

  1. 「 戦略」で、 APM section.
  2. ルールテーブルを表示します。
  3. ドラッグ＆ドロップで優先順位を再設定します。
  4. 上位にあるルールは最初に評価されます。
  5. 特定のルールに一致しない場合は、デフォルトのクレデンシャルが使用されます。

APM 向けの不正検知評価#

DEUNA は、APM トランザクションを不正リスクの評価のために事前に評価できる機能を提供します。 APM プロバイダーに送信する前に 支払いを行います。この機能により、PSP ベースのカードフローと同様のレベルの不正保護を、代替決済方法にも適用できます。

不正検知を APM で行う理由

例えば、PayPal などの一部の APM は、依然として不正損失、紛争、またはチャージバックを引き起こす可能性があります。これらのトランザクションをより詳細に制御したい場合は、トランザクションが APM に到達する前に、不正検知プロバイダーを設定して評価できます。これにより、リスクの高いトランザクションを早期にブロックし、不正に関連する損失を軽減できます。

仕組み

不正検知をサポートする APM フローで有効にすると、DEUNA は支払いフローに 事前 APM オーケストレーションステップ を追加します。

  1. 顧客は、サポートされている APM (例: PayPal) を使用して支払いを開始します。
  2. DEUNA は、設定された不正検知プロバイダーを通じてトランザクションを評価し、APM に送信します。 APM プロバイダーに送信する前に 不正検知プロバイダーはリスク評価を返します。
  3. 低リスク
  4. DEUNAは、応答を標準化されたリスク結果に変換します。 中リスク, 高リスク、または DEUNA は、設定されたリスクレベルに応じて、次のアクションを適用します。.
  5. 承認 (ルーティング):
    • トランザクションは APM での支払い処理に進みます。 拒否 (ブロック):
    • DEUNA は、トランザクションが APM に到達する前に停止します。 アクションが「承認」の場合、支払い情報は正しい APM 固有のペイロードとともに APM に送信されます。
  6. すべての APM が不正検知評価をサポートしているわけではありません。DEUNA は、将来の段階で、BNPL、銀行振込、またはバウチャーベースの方法など、追加の APM をサポートします。

ステップ 1: 不正検知プロバイダーを接続する#

DEUNA Admin

  1. DEUNAにログインする 使用する APM の評価用の不正検知プロバイダーを選択および設定します (例: Cybersource または Riskified)。.
  2. 以下のパスに移動する 接続.
  3. プロバイダー固有の設定手順を
  4. ドキュメントで参照してください。 不正行為対策エンジン documentation.

DEUNA Admin で、

  1. 「 戦略.
  2. 」に移動します。 APM tab.
  3. サポートされている APM (例: PayPal) のためのルーティングルールを作成または編集します。
  4. ルールで不正検知評価を有効にし、不正検知プロバイダーを選択します。
  5. 設定されたリスクレベルの各正規化された結果のアクションを設定します。
    • 低リスク： Permitir o Bloquear
    • 中リスク： Permitir o Bloquear
    • 高リスク： Permitir o Bloquear
  6. ルールを保存します。

ステップ 3: 詳細ページで検証

取引処理後、不正検知機能が正しく動作していることを確認してください。

  1. 以下のパスに移動する 取引 > 注文詳細.
  2. 以下の情報が表示されていることを確認してください。
    • APMの前に不正行為が実行されたかどうか。
    • 使用された不正行為プロバイダー。
    • 正規化されたリスク結果（低/中/高）。
    • DEUNAが適用したアクション（許可/拒否）。
    • 不正行為のステップの実行タイミング。

不正行為によってブロックされた取引は、APM層で拒否または失敗した取引と明確に区別されます。

取引の可視性#

APM を介して処理されたすべてのトランザクション — 詐欺防止機能がある場合でも、完全な追跡が可能です。

ルーティングの追跡可能性

  1. 「 取引、[リンク]にアクセス 取引の詳細.
  2. JSONリクエストとレスポンスを表示。
  3. 適用されたルーティングルールを確認。
  4. 使用されている特定の商社決済プロセッサの名前を特定。

不正行為の追跡可能性

APMフローで不正行為が有効になっている場合、注文詳細には以下が含まれます。

  • APMフローで使用される不正行為プロバイダー 評価に使用。
  • 正規化されたリスク結果 (低リスク、中リスク、または高リスク)。
  • DEUNAが適用したアクション (許可/拒否)。

取引可視性イベント

DEUNAは、APM不正行為フローに対して、以下の取引可視性イベントを生成します。

イベント説明
tv_fraud_analysis不正行為の評価が完了したときに生成されます。 response_data ペイロードには、トランザクションに関連付けられたAPM識別子とAPM名が含まれており、評価された代替支払い方法が明確に示されます。
tv_antifraud_unavailable不正行為プロバイダーが応答を返さない、タイムアウトした場合、または技術的なエラーが発生した場合に生成されます。失敗理由が含まれます。

APM資格情報の管理#

DEUNAでAPM資格情報を管理します。

デフォルトのAPMを変更

  1. 「 戦略」で、 APM section.
  2. 設定したい資格情報を見つけます。
  3. クリック デフォルトに設定.

資格情報を削除

APM資格情報を削除する場合：

  • デフォルトの場合： 新しいデフォルト資格情報を選択
  • Si se utiliza en reglas activas:
    • 関連するルールを無効化します。
    • ルールを別の資格情報に再割り当てします。

これにより、支払いルーティングの誤った中断を防ぐことができます。

ルールの管理#

DEUNA Adminは、あなたのルーティングルールに対する完全な制御を提供します。

ルールのアクション：

  • 作成: 新しいルーティングルールを定義
  • 編集: 既存のルールの条件または割り当てを変更
  • 無効化- 削除せずにルールを一時的に無効化
  • ドラフトとして保存: 活性化する前にルールを準備

ルール可視性：

すべてのルールは、以下の情報を含む包括的なテーブルに表示されます。

  • 優先度
  • ルール名
  • 作成日
  • APMプロバイダー
  • ステータス（アクティブ/無効/ドラフト）

一般的なユースケース#

APM ルーティングの一般的なユースケースについて

ユースケース1：為替に基づくルーティング

シナリオ: MXN と USD で PayPal 決済を別のアカウントで行っています。

設定:

  1. PayPal MXN の認証情報をデフォルトとして設定します。
  2. PayPal USD の認証情報を設定します。
  3. ルールを作成:
    1. "Currency = USD"
    2. USD へのルーティング
  4. デフォルトルールは MXN 決済を自動的に処理します。

USD 決済はデフォルトで PayPal USD 認証を使用し、MXN 決済は PayPal MXN 認証を使用します。

ユースケース 2: 国別ルーティング

シナリオ: メキシコと米国で異なる PayPal アカウントを使用しています。

設定:

  1. ルールを作成: "Country = US" で PayPal US へのルーティング
  2. ルールを作成: "Country = MX" で PayPal MX へのルーティング
  3. いずれかをデフォルトとして設定し、他の国には適用

結果: 各国のトランザクションは、適切な地域アカウントにルーティングされます。

ユースケース 3: 特定の決済の拒否

シナリオ: USD の注文を処理せずに拒否したい。

設定:

  1. ルールを作成: "Currency = USD" を拒否設定に設定
  2. デフォルトルールは、他の通貨の決済を通常通り処理します。

結果: USD 決済は処理前に自動的に拒否され、他の通貨の決済は通常通り処理されます。

ユースケース 4: APM プリフライトの不正検知

シナリオ: PayPalのトランザクションを、Cybersourceなどの不正検知プロバイダーを通じて評価し、高リスクのトランザクションを決済実行前にブロックしたい場合。

設定:

  1. 不正検知に関する情報を連携 接続.
  2. 以下のパスに移動する 戦略 > APM.
  3. ルーティングルールを作成します。
  4. 不正検知機能を有効にし、不正検知プロバイダー（例：Cybersource）を選択します。
  5. リスク対応を設定:
    • 低リスク： Ex. PayPalウォレットとの連携を許可
    • 中リスク： 許可 -> 例：PayPal ウォレット
    • 高リスク： ブロック
  6. ルールを保存します。

結果: すべてのPayPal取引は、PayPalに到達する前にCybersourceによって評価されます。 低リスクおよび中リスクの取引は通常通り処理されますが、高リスクの取引はブロックされます。 注文の詳細には、不正検知の評価結果と適用されたアクションが表示されます。

ベストプラクティスと制限#

  1. 常にデフォルトを設定: APM が特定のルールに一致しないトランザクションを処理するためのデフォルト認証情報を必ず設定してください。
  2. トランザクションログを監視: トランザクションの詳細を定期的に確認し、ルーティングが期待どおりに動作していることを確認し、フォールバックの使用状況を特定します。
  3. 戦略を文書化する: 各ルールが存在する理由と、それが提供するビジネスロジックを説明する内部ドキュメントを維持します。
  4. まずはシンプルに: まず、基本的な通貨ベースのルーティングから開始し、次に複雑なマルチ条件ルールを追加します。
  5. 不正検知の結果を確認: APM で不正検知を有効にすると、注文の詳細を定期的に確認し、リスクの結果とアクションが、不正防止の目標と一致していることを確認します。

以下の制限事項を考慮してください:

  • APM のカスケードはできません: トランザクションは異なる APM アカウント間でカスケードできません。 1 つのトランザクションは、正確に 1 つの認証情報にルーティングされます。
  • APM 間でのルーティングはできません: 注文を異なる APM にルーティングすることはできません。
  • AND ロジックのみ: ルール内の複数の条件をAND（ORではない）で組み合わせます
  • ルール評価順序: ルールは優先度に基づいて評価され、作成日ではありません。
  • 即時効果: ルールは新しいトランザクションに対して即座に有効になります。
  • サポートされている組み合わせのみ: APM での不正検知は、明確にサポートされている APM + 不正検知プロバイダーの組み合わせでのみ利用可能です。 管理者はサポートされていない構成を防止します。
  • 手動レビューが必要なリバウンド: 手動レビューベースの不正検知フローでは、APM がリバウンドをサポートする必要があります。 APM がリバウンドをサポートしない場合、手動レビューフローは利用できません。