Translation disclaimer

Documentation is written in English and subsequently translated. This page, therefore, might not have the most up-to-date content. If any questions arise relating to the accuracy of the translated content, please refer to the English version of the page.

Menu

不正評価

POST fraudsight:assessアクションリンクへのリクエスト。

評価例のリクエスト

POST https://try.access.worldpay.com/fraudsight/assessment

リスク評価リクエスト本文:

Copied!
{
  "transactionReference": "Memory265-13/08/1876",
  "merchant": {
      "entity": "MindPalaceLtd"
  },
  "instruction": {
    "paymentInstrument": {
      "type": "card/front",
      "cardHolderName": "Sherlock Holmes",
      "cardNumber": "4444333322221111",
      "cardExpiryDate": {
        "month": 5,
        "year": 2035
      },
      "billingAddress": {
          "address1": "221B Baker Street",
          "address2": "Marylebone",
          "address3": "Westminster",
          "postalCode": "NW1 6XE",
          "city": "London",
          "state": "Greater London",
          "countryCode": "GB"
      }
    },
    "value": {
      "currency": "GBP",
      "amount": 250
    }
  },
  "deviceData": {
    "collectionReference": "0_4XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX8G6",
    "ipAddress": "192.0.0.0"
  },
  "riskData": {
    "account": {
      "email": "sherlock.holmes@example.com",
      "dateOfBirth": "1854-01-06",
      "shopperId": "id123"
    },
    "transaction": {
      "firstName": "Sherlock",
      "lastName": "Holmes",
      "phoneNumber": "02031234321"
    },
    "shipping": {
      "firstName": "James",
      "lastName": "Moriarty",
      "address": {
        "address1": "The Palatine Centre",
        "address2": "Durham University",
        "address3": "Stockton Road",
        "postalCode": "DH1 3LE",
        "city": "Durham",
        "state": "County Durham",
        "countryCode": "GB",
        "phoneNumber": "01911234321"
      }
    },
    "custom": {
      "number1": 1,
      "number2": 2,
      "number3": 3,
      "number4": 4,
      "number5": 5,
      "number6": 6,
      "number7": 7,
      "number8": 8,
      "number9": 9,
      "string1": "text1",
      "string2": "text2",
      "string3": "text3",
      "string4": "text4",
      "string5": "text5",
      "string6": "text6",
      "string7": "text7",
      "string8": "text8",
      "string9": "text9"
    }
  }
}
{
  "transactionReference": "Memory265-13/08/1876",
  "merchant": {
      "entity": "MindPalaceLtd"
  },
  "instruction": {
    "paymentInstrument": {
      "type": "card/tokenized",
      "href": "https://try.access.worldpay.com/tokens/MTIzNDU2Nzg5MDEyMzQ1Ng"
    },
    "value": {
      "currency": "GBP",
      "amount": 250
    }
  },
  "deviceData": {
    "collectionReference": "0_4XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX8G6",
    "ipAddress": "192.0.0.0"
  },
  "riskData": {
    "account": {
      "email": "sherlock.holmes@example.com",
      "dateOfBirth": "1854-01-06",
      "shopperId": "id123"
    },
    "transaction": {
      "firstName": "Sherlock",
      "lastName": "Holmes",
      "phoneNumber": "02031234321"
    },
    "shipping": {
      "firstName": "James",
      "lastName": "Moriarty",
      "address": {
        "address1": "The Palatine Centre",
        "address2": "Durham University",
        "address3": "Stockton Road",
        "postalCode": "DH1 3LE",
        "city": "Durham",
        "state": "County Durham",
        "countryCode": "GB",
        "phoneNumber": "01911234321"
      }
    },
    "custom": {
      "number1": 1,
      "number2": 2,
      "number3": 3,
      "number4": 4,
      "number5": 5,
      "number6": 6,
      "number7": 7,
      "number8": 8,
      "number9": 9,
      "string1": "text1",
      "string2": "text2",
      "string3": "text3",
      "string4": "text4",
      "string5": "text5",
      "string6": "text6",
      "string7": "text7",
      "string8": "text8",
      "string9": "text9"
    }
  }
}
{
  "transactionReference": "Memory265-13/08/1876",
  "merchant": {
      "entity": "MindPalaceLtd"
  },
  "requestExemption": true,
  "instruction": {
    "paymentInstrument": {
      "type": "card/front",
      "cardHolderName": "Sherlock Holmes",
      "cardNumber": "4444333322221111",
      "cardExpiryDate": {
        "month": 5,
        "year": 2035
      },
      "billingAddress": {
          "address1": "221B Baker Street",
          "address2": "Marylebone",
          "address3": "Westminster",
          "postalCode": "NW1 6XE",
          "city": "London",
          "state": "Greater London",
          "countryCode": "GB"
      }
    },
    "value": {
      "currency": "GBP",
      "amount": 250
    }
  },
  "deviceData": {
    "collectionReference": "0_4XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX8G6",
    "ipAddress": "192.0.0.0"
  },
  "riskData": {
    "account": {
      "email": "sherlock.holmes@example.com",
      "dateOfBirth": "1990-09-09",
      "shopperId": "id123"
    },
    "transaction": {
      "firstName": "Sherlock",
      "lastName": "Holmes",
      "phoneNumber": "00000000000000"
    },
    "shipping": {
      "firstName": "James",
      "lastName": "Moriarty",
      "address": {
        "address1": "The Palatine Centre",
        "address2": "Durham University",
        "address3": "Stockton Road",
        "postalCode": "DH1 3LE",
        "city": "Durham",
        "state": "County Durham",
        "countryCode": "GB",
        "phoneNumber": "01911234321"
      }
    },
    "custom": {
      "number1": 1,
      "number2": 2,
      "number3": 3,
      "number4": 4,
      "number5": 5,
      "number6": 6,
      "number7": 7,
      "number8": 8,
      "number9": 9,
      "string1": "text1",
      "string2": "text2",
      "string3": "text3",
      "string4": "text4",
      "string5": "text5",
      "string6": "text6",
      "string7": "text7",
      "string8": "text8",
      "string9": "text9"
    }
  }
}
必須パラメーターの説明
transactionReference評価のためのリファレンス。例えば、Eコマースのオーダーコード。
merchant.entityオンボーディングの一部として作成したAccess Worldpayで評価リクエストをルーティングするために使用されて来ました。
requestExemption同じリクエストの一部としてSCA免除をリクエストすること。
  • true
  • false
instruction評価リクエストに関連する全ての支払情報を含むオブジェクト。
instruction.paymentInstrumentカードの詳細またはトークンの保存先を含むオブジェクト。
paymentInstrument.typepaymentInstrument用の使用されている識別子。

typecard/fronttypecard/tokenized
paymentInstrument.billingAddress請求先住所情報を含むオブジェクト。含まれている場合は、少なくとも以下を送信しなければなりません。
instruction.value注文の総額に関する情報を含むオブジェクト。
value.currency3桁の通貨コード。
サポートされている通貨の一覧を参照してください。
value.amount注文額指数を含む整数です。e.g.指数が2の場合、250は2.50.です。関連する指数は、通貨表でご確認いただけます。
評価リクエストの金額は、riskProfileを適用する際のアクセス支払リクエストの支払金額と同額でなければなりません。
deviceData.collectionReferenceThreatmatrixデバイスデータコレクションで指定されたsessionIdで、このデータを評価にリンクします。

注記:値が提供されない場合でも、評価は実行されますが、追加のリスク分析またはそれに基づく手動ルール(e.g.保存先)の恩恵を受けることはありません。

評価リクエストの追加フィールド

このデータが存在する場合は、不正評価の精度が向上するため、このデータを提供することをお勧めします。

リクエストに含めることができるriskDataオブジェクトは4つあります。

評価の回答

ベストプラクティス:Access Worldpayは、サービス応答のヘッダーでWP-CorrelationIdを返します。これをログに記録することを強くお勧めします。各サービスリクエストを確認するためにWP-CorrelationIdを使用します。

応答には、assessmentリクエストの結果が含まれます。

Copied!
{
  "outcome": "lowRisk",
  "transactionReference": "123456",
  "score": 44.2,
  "riskProfile": {
    "href": "https://access.worldpay.com/riskprofile/eyJrIjoxLCJkIjoialRBL0FFelBzcnZ"
  }
}
{
  "outcome": "highRisk",
  "transactionReference": "123456",
  "reason": [
    "Recent unexpected card activity"
  ],
  "score": 97.4,
  "riskProfile": {
    "href": "https://access.worldpay.com/riskprofile/eyJrIjoxLCJkIjoialRBL0FFelBzcnZ"
  }
}
{
  "outcome": "review",
  "transactionReference": "123456",
  "reason": [
    "Recent unexpected card activity"
  ],
  "score": 85.5,
  "riskProfile": {
    "href": "https://access.worldpay.com/riskprofile/eyJrIjoxLCJkIjoialRBL0FFelBzcnZ"
  }
}
{
  "outcome": "lowRisk",
  "transactionReference": "123456",
  "score": 44.2,
  "exemption": {
    "placement": "authorization",
    "type": "lowValue"
  },
  "riskProfile": {
    "href": "https://access.worldpay.com/riskprofile/eyJrIjoxLCJkIjoialRBL0FFelBzcnZ"
  }
}
{
  "outcome": "highRisk",
  "transactionReference": "123456",
  "reason": [
    "Recent unexpected card activity"
  ],
  "score": 97.4,
  "exemption": {
    "placement": "authorization",
    "type": "lowValue"
  },
  "riskProfile": {
    "href": "https://access.worldpay.com/riskprofile/eyJrIjoxLCJkIjoialRBL0FFelBzcnZ"
  }
}
{
  "outcome": "review",
  "transactionReference": "123456",
  "reason": [
    "Recent unexpected card activity"
  ],
  "score": 85.5,
  "exemption": {
    "placement": "authorization",
    "type": "lowValue"
  },
  "riskProfile": {
    "href": "https://access.worldpay.com/riskprofile/eyJrIjoxLCJkIjoialRBL0FFelBzcnZ"
  }
}

注記:outcomeは常に不正評価に固有のものです。免除が提供されている場合、exemption.typeおよびexemption.placementは応答に含まれます。

パラメーター説明
outcomeFraudSightからの推奨事項:
  • lowRisk- 支払いを続行します
  • highRisk - 続行しません
  • review - 手動レビューが必要です。
outcomesの詳細、および再現方法については、FraudSight testingテストを参照してください。
reason結果の理由の簡単な説明:
  • 最近の予期しないカードアクティビティ
  • 馴染みのないカード
  • カードの種類が不正に関連していることが多い
  • 加盟店の異常な取引
  • カード所有者が入力した情報の不規則性
  • 高リスクの電子メール
  • カードの異常な動作理由
低リスクであっても、あらゆる「結果」に対して返される可能性があります。
score取引のパーセンテージ評価スコア。値が高いほど、評価されるリスクは大きくなります。outcome値は、このスコアを基に構成されたしきい値に基づいています。
exemption.placement
  • authorization - 支払承認に免除を適用します
  • authentication - 3DS認証に免除を適用します

注記:Access 3DSが免除プレースメントをサポートするまで、プレースメント「承認」のみが返されるように構成されます。

exemption.type適用する免除の種類
  • lowRisk - 低リスク免除を適用する
  • lowValue - 低価値免除を適用する
riskProfile.href不正評価と免除の結果を表す、支払承認リクエストで使用できるリソース。使用:
  • 免除を適用します(提供されている場合)
  • データモデルを更新して、将来の評価がより正確になるようにします

FraudSight評価のリンク

将来のリスク評価を改善するには、支払承認の結果を知らなければなりません。

Access Paymentsを使用する場合は、提供されたriskProfile支払承認リクエストに適用します。

別の支払プロバイダーを基にいる場合は、FraudSightアップデートリソースを使用してください(近日公開予定)。

次の手順


FraudSightテスト