不正評価
POST
fraudsight:assess
アクションリンクへのリクエスト。
評価例のリクエスト
POST https://try.access.worldpay.com/fraudsight/assessment
リスク評価リクエスト本文:
{
"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 | 同じリクエストの一部として
| |
instruction | 評価リクエストに関連する全ての支払情報を含むオブジェクト。 | |
instruction.paymentInstrument | カードの詳細またはトークンの保存先を含むオブジェクト。 | |
paymentInstrument.type | paymentInstrument 用の使用されている識別子。type :card/front
type : card/tokenized
| |
paymentInstrument.billingAddress | 請求先住所情報を含むオブジェクト。含まれている場合は、少なくとも以下を送信しなければなりません。
| |
instruction.value | 注文の総額に関する情報を含むオブジェクト。 | |
value.currency | 3桁の通貨コード。 | |
value.amount | 注文額指数を含む整数です。e.g.指数が2の場合、250は2.50.です。関連する指数は、 評価リクエストの金額は、 riskProfile を適用する際のアクセス支払リクエストの支払金額と同額でなければなりません。 | |
deviceData.collectionReference | Threatmatrix 注記:値が提供されない場合でも、評価は実行されますが、追加のリスク分析またはそれに基づく手動ルール(e.g.保存先)の恩恵を受けることはありません。 |
評価リクエストの追加フィールド
このデータが存在する場合は、不正評価の精度が向上するため、このデータを提供することをお勧めします。
リクエストに含めることができるriskData
オブジェクトは4つあります。
追加のアカウントriskData
パラメーターの説明:
パラメーター | 必須 | 説明 |
---|---|---|
account | 全ての顧客アカウント関連のリスクデータを含むオブジェクト。 | |
account.email | 顧客の電子メールアドレス。 | |
account.dateOfBirth | 顧客の生年月日。 |
追加の取引riskData
パラメーターの説明:
必須 | パラメーターの説明 | |
---|---|---|
transaction | 全ての顧客取引関連のリスクデータを含むオブジェクト。 | |
transaction.firstName | 顧客の名(ファーストネーム)。 | |
transaction.lastName | 顧客の姓(ラストネーム)。 | |
transaction.phoneNumber | 顧客の電話番号。 |
追加の配送riskData
パラメーターの説明:
必須 | パラメーターの説明 | |
---|---|---|
shipping | 注文の発送方法に関連するすべてのデータを含むオブジェクト。 | |
shipping.firstName | 配送先住所で使用されている名(ファーストネーム) | |
shipping.lastName | 配送先住所で使用されている姓(ラストネーム) | |
shipping.address | 出荷先住所情報を含むオブジェクト。含まれている場合は、少なくとも以下を送信しなければなりません。
|
マニュアル不正ルールを作成するために使用する、注文に固有の追加の値。
必須 | パラメーターの説明 | |
---|---|---|
custom | マニュアル不正ルールの構成に使用できるすべてのデータを含むオブジェクト | |
custom.string1-9 | 9の手動の不正ルールを構成するために使用するカスタム文字列値に使用可能なスロット | |
custom.number1-9 | 9のマニュアル不正ルールを構成するために使用するカスタム番号値に使用可能なスロット |
評価の回答
ベストプラクティス:Access Worldpayは、サービス応答のヘッダーでWP-CorrelationId
を返します。これをログに記録することを強くお勧めします。各サービスリクエストを確認するためにWP-CorrelationId
を使用します。
応答には、assessment
リクエストの結果が含まれます。
{
"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
は応答に含まれます。
パラメーター | 説明 |
---|---|
outcome | FraudSightからの推奨事項:
outcomes の詳細、および再現方法については、 |
reason | 結果の理由の簡単な説明:
|
score | 取引のパーセンテージ評価スコア。値が高いほど、評価されるリスクは大きくなります。outcome 値は、このスコアを基に構成されたしきい値に基づいています。 |
exemption.placement |
注記:Access 3DSが免除プレースメントをサポートするまで、プレースメント「承認」のみが返されるように構成されます。 |
exemption.type | 適用する免除の種類
|
riskProfile.href | 不正評価と免除の結果を表す、支払承認リクエストで使用できるリソース。使用:
|
FraudSight評価のリンク
将来のリスク評価を改善するには、支払承認の結果を知らなければなりません。
riskProfile
を
別の支払プロバイダーを基にいる場合は、
次の手順