Assessment
Assess for fraud
Methods
POST
Assess for fraud
Request
Copied!
{
"type": "object",
"required": [
"transactionReference",
"merchant",
"instruction"
],
"properties": {
"transactionReference": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$"
},
"merchant": {
"type": "object",
"required": [
"entity"
],
"properties": {
"entity": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[A-Za-z0-9 ]*$"
}
}
},
"requestExemption": {
"type": "boolean"
},
"doNotApplyExemption": {
"type": "boolean"
},
"instruction": {
"type": "object",
"properties": {
"value": {
"type": "object",
"properties": {
"amount": {
"type": "integer",
"minimum": 0,
"maximum": 999999999
},
"currency": {
"type": "string",
"minLength": 3,
"maxLength": 3,
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"amount",
"currency"
]
},
"paymentInstrument": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "card/front"
},
"billingAddress": {
"type": "object",
"properties": {
"city": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"state": {
"type": "string",
"minLength": 1,
"maxLength": 30
},
"address1": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"address2": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"address3": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"postalCode": {
"type": "string",
"minLength": 1,
"maxLength": 15
},
"countryCode": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"pattern": "^[A-Z]{2}$"
}
},
"required": [
"address1",
"city",
"postalCode",
"countryCode"
]
},
"cardHolderName": {
"type": "string",
"minLength": 1,
"maxLength": 255
},
"cardExpiryDate": {
"type": "object",
"properties": {
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"year": {
"type": "integer",
"minimum": 1,
"maximum": 9999
}
},
"required": [
"month",
"year"
]
},
"cardNumber": {
"type": "string",
"minLength": 10,
"maxLength": 19,
"pattern": "^[0-9]*$"
}
},
"required": [
"type",
"cardNumber",
"cardExpiryDate"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "card/tokenized"
},
"href": {
"type": "string",
"minLength": 1
}
},
"required": [
"type",
"href"
]
}
]
}
},
"required": [
"value",
"paymentInstrument"
]
},
"riskData": {
"type": "object",
"properties": {
"account": {
"type": "object",
"properties": {
"shopperId": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"email": {
"type": "string",
"minLength": 3,
"maxLength": 254,
"pattern": "^.+@.+$"
},
"dateOfBirth": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"format": "date"
}
}
},
"transaction": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"minLength": 1,
"maxLength": 22,
"pattern": "^[a-zA-Z]*$"
},
"lastName": {
"type": "string",
"minLength": 1,
"maxLength": 22,
"pattern": "^[a-zA-Z]*$"
},
"phoneNumber": {
"type": "string",
"minLength": 4,
"maxLength": 20,
"pattern": "^[0-9]*$"
}
}
},
"shipping": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"minLength": 1,
"maxLength": 22,
"pattern": "^[a-zA-Z]*$"
},
"lastName": {
"type": "string",
"minLength": 1,
"maxLength": 22,
"pattern": "^[a-zA-Z]*$"
},
"address": {
"type": "object",
"properties": {
"city": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"state": {
"type": "string",
"minLength": 1,
"maxLength": 30
},
"address1": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"address2": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"address3": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"postalCode": {
"type": "string",
"minLength": 1,
"maxLength": 15
},
"countryCode": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"pattern": "^[A-Z]{2}$"
},
"phoneNumber": {
"type": "string",
"minLength": 4,
"maxLength": 20,
"pattern": "^[0-9]*$"
}
},
"required": [
"address1",
"city",
"postalCode",
"countryCode"
]
}
}
},
"custom": {
"type": "object",
"properties": {
"number1": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"number2": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"number3": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"number4": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"number5": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"number6": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"number7": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"number8": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"number9": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"number10": {
"type": "integer",
"minimum": -2147483648,
"maximum": 2147483647
},
"string1": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"string2": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"string3": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"string4": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"string5": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"string6": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"string7": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"string8": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"string9": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"string10": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
}
}
}
},
"deviceData": {
"type": "object",
"properties": {
"collectionReference": {
"type": "string",
"minLength": 30,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]*$"
},
"ipAddress": {
"type": "string",
"minLength": 1
}
}
}
}
}
{ "type": "object", "required": [ "transactionReference", "merchant", "instruction" ], "properties": { "transactionReference": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$" }, "merchant": { "type": "object", "required": [ "entity" ], "properties": { "entity": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9 ]*$" } } }, "requestExemption": { "type": "boolean" }, "doNotApplyExemption": { "type": "boolean" }, "instruction": { "type": "object", "properties": { "value": { "type": "object", "properties": { "amount": { "type": "integer", "minimum": 0, "maximum": 999999999 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "pattern": "^[A-Z]{3}$" } }, "required": [ "amount", "currency" ] }, "paymentInstrument": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "card/front" }, "billingAddress": { "type": "object", "properties": { "city": { "type": "string", "minLength": 1, "maxLength": 50 }, "state": { "type": "string", "minLength": 1, "maxLength": 30 }, "address1": { "type": "string", "minLength": 1, "maxLength": 80 }, "address2": { "type": "string", "minLength": 1, "maxLength": 80 }, "address3": { "type": "string", "minLength": 1, "maxLength": 80 }, "postalCode": { "type": "string", "minLength": 1, "maxLength": 15 }, "countryCode": { "type": "string", "minLength": 2, "maxLength": 2, "pattern": "^[A-Z]{2}$" } }, "required": [ "address1", "city", "postalCode", "countryCode" ] }, "cardHolderName": { "type": "string", "minLength": 1, "maxLength": 255 }, "cardExpiryDate": { "type": "object", "properties": { "month": { "type": "integer", "minimum": 1, "maximum": 12 }, "year": { "type": "integer", "minimum": 1, "maximum": 9999 } }, "required": [ "month", "year" ] }, "cardNumber": { "type": "string", "minLength": 10, "maxLength": 19, "pattern": "^[0-9]*$" } }, "required": [ "type", "cardNumber", "cardExpiryDate" ] }, { "type": "object", "properties": { "type": { "type": "string", "const": "card/tokenized" }, "href": { "type": "string", "minLength": 1 } }, "required": [ "type", "href" ] } ] } }, "required": [ "value", "paymentInstrument" ] }, "riskData": { "type": "object", "properties": { "account": { "type": "object", "properties": { "shopperId": { "type": "string", "minLength": 1, "maxLength": 128 }, "email": { "type": "string", "minLength": 3, "maxLength": 254, "pattern": "^.+@.+$" }, "dateOfBirth": { "type": "string", "minLength": 1, "maxLength": 20, "format": "date" } } }, "transaction": { "type": "object", "properties": { "firstName": { "type": "string", "minLength": 1, "maxLength": 22, "pattern": "^[a-zA-Z]*$" }, "lastName": { "type": "string", "minLength": 1, "maxLength": 22, "pattern": "^[a-zA-Z]*$" }, "phoneNumber": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^[0-9]*$" } } }, "shipping": { "type": "object", "properties": { "firstName": { "type": "string", "minLength": 1, "maxLength": 22, "pattern": "^[a-zA-Z]*$" }, "lastName": { "type": "string", "minLength": 1, "maxLength": 22, "pattern": "^[a-zA-Z]*$" }, "address": { "type": "object", "properties": { "city": { "type": "string", "minLength": 1, "maxLength": 50 }, "state": { "type": "string", "minLength": 1, "maxLength": 30 }, "address1": { "type": "string", "minLength": 1, "maxLength": 80 }, "address2": { "type": "string", "minLength": 1, "maxLength": 80 }, "address3": { "type": "string", "minLength": 1, "maxLength": 80 }, "postalCode": { "type": "string", "minLength": 1, "maxLength": 15 }, "countryCode": { "type": "string", "minLength": 2, "maxLength": 2, "pattern": "^[A-Z]{2}$" }, "phoneNumber": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^[0-9]*$" } }, "required": [ "address1", "city", "postalCode", "countryCode" ] } } }, "custom": { "type": "object", "properties": { "number1": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "number2": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "number3": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "number4": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "number5": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "number6": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "number7": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "number8": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "number9": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "number10": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 }, "string1": { "type": "string", "minLength": 1, "maxLength": 100 }, "string2": { "type": "string", "minLength": 1, "maxLength": 100 }, "string3": { "type": "string", "minLength": 1, "maxLength": 100 }, "string4": { "type": "string", "minLength": 1, "maxLength": 100 }, "string5": { "type": "string", "minLength": 1, "maxLength": 100 }, "string6": { "type": "string", "minLength": 1, "maxLength": 100 }, "string7": { "type": "string", "minLength": 1, "maxLength": 100 }, "string8": { "type": "string", "minLength": 1, "maxLength": 100 }, "string9": { "type": "string", "minLength": 1, "maxLength": 100 }, "string10": { "type": "string", "minLength": 1, "maxLength": 100 } } } } }, "deviceData": { "type": "object", "properties": { "collectionReference": { "type": "string", "minLength": 30, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]*$" }, "ipAddress": { "type": "string", "minLength": 1 } } } } }
Responses
Response schema
Copied!
{
"type": "object",
"properties": {
"outcome": {
"type": "string",
"enum": [
"lowRisk",
"highRisk",
"review"
]
},
"transactionReference": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"score": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"reason": {
"type": "array",
"maxItems": 10,
"items": {
"type": "string"
}
},
"exemption": {
"type": "object",
"properties": {
"placement": {
"type": "string",
"enum": [
"authorization",
"authentication"
]
},
"type": {
"type": "string",
"enum": [
"lowValue",
"lowRisk"
]
}
},
"required": [
"placement",
"type"
]
},
"riskProfile": {
"type": "object",
"properties": {
"href": {
"type": "string",
"minLength": 30,
"maxLength": 1024,
"format": "uri"
}
},
"required": [
"href"
]
}
},
"required": [
"outcome",
"transactionReference",
"riskProfile"
]
}
{ "type": "object", "properties": { "outcome": { "type": "string", "enum": [ "lowRisk", "highRisk", "review" ] }, "transactionReference": { "type": "string", "minLength": 1, "maxLength": 64 }, "score": { "type": "number", "minimum": 0, "maximum": 100 }, "reason": { "type": "array", "maxItems": 10, "items": { "type": "string" } }, "exemption": { "type": "object", "properties": { "placement": { "type": "string", "enum": [ "authorization", "authentication" ] }, "type": { "type": "string", "enum": [ "lowValue", "lowRisk" ] } }, "required": [ "placement", "type" ] }, "riskProfile": { "type": "object", "properties": { "href": { "type": "string", "minLength": 30, "maxLength": 1024, "format": "uri" } }, "required": [ "href" ] } }, "required": [ "outcome", "transactionReference", "riskProfile" ] }
Link relationship
fraudsight:assess
Assess for fraud
An assessment request using a cardPaymentInstrument where review fraud assessment is returned
POSThttps://try.access.worldpay.com/fraudsight/assessment
Copied!
{
"Authorization": "Basic dXNlcjE6cGFzc3dvcmQ=",
"Content-Type": "application/vnd.worldpay.fraudsight-v1.hal+json"
}
{ "Authorization": "Basic dXNlcjE6cGFzc3dvcmQ=", "Content-Type": "application/vnd.worldpay.fraudsight-v1.hal+json" }
Copied!
{
"transactionReference": "reference",
"merchant": {
"entity": "default"
},
"instruction": {
"paymentInstrument": {
"type": "card/front",
"cardHolderName": "John Appleseed",
"cardNumber": "4444333322221111",
"cardExpiryDate": {
"month": 5,
"year": 2035
},
"billingAddress": {
"address1": "Worldpay",
"address2": "1 Milton Road",
"address3": "The Science Park",
"postalCode": "CB4 0WE",
"city": "Cambridge",
"state": "Cambridgeshire",
"countryCode": "GB"
}
},
"value": {
"currency": "GBP",
"amount": 250
}
},
"riskData": {
"account": {
"email": "test@test.com",
"dateOfBirth": "1990-09-09"
},
"transaction": {
"firstName": "John",
"lastName": "Appleseed",
"phoneNumber": "00000000000000"
},
"shipping": {
"firstName": "Bob",
"lastName": "Smith",
"address": {
"address1": "Worldpay",
"address2": "1 Milton Road",
"address3": "The Science Park",
"postalCode": "CB4 0WE",
"city": "Cambridge",
"state": "Cambridgeshire",
"countryCode": "GB",
"phoneNumber": "00000000000000"
}
},
"custom": {
"string1": "text1",
"string2": "text2",
"string3": "text3",
"string4": "text4",
"string5": "text5",
"string6": "text6",
"string7": "text7",
"string8": "text8",
"string9": "text9",
"string10": "text10",
"number1": 10
}
}
}
{ "transactionReference": "reference", "merchant": { "entity": "default" }, "instruction": { "paymentInstrument": { "type": "card/front", "cardHolderName": "John Appleseed", "cardNumber": "4444333322221111", "cardExpiryDate": { "month": 5, "year": 2035 }, "billingAddress": { "address1": "Worldpay", "address2": "1 Milton Road", "address3": "The Science Park", "postalCode": "CB4 0WE", "city": "Cambridge", "state": "Cambridgeshire", "countryCode": "GB" } }, "value": { "currency": "GBP", "amount": 250 } }, "riskData": { "account": { "email": "test@test.com", "dateOfBirth": "1990-09-09" }, "transaction": { "firstName": "John", "lastName": "Appleseed", "phoneNumber": "00000000000000" }, "shipping": { "firstName": "Bob", "lastName": "Smith", "address": { "address1": "Worldpay", "address2": "1 Milton Road", "address3": "The Science Park", "postalCode": "CB4 0WE", "city": "Cambridge", "state": "Cambridgeshire", "countryCode": "GB", "phoneNumber": "00000000000000" } }, "custom": { "string1": "text1", "string2": "text2", "string3": "text3", "string4": "text4", "string5": "text5", "string6": "text6", "string7": "text7", "string8": "text8", "string9": "text9", "string10": "text10", "number1": 10 } } }
200
Copied!
{
"Content-Type": "application/vnd.worldpay.fraudsight-v1.hal+json"
}
{ "Content-Type": "application/vnd.worldpay.fraudsight-v1.hal+json" }
Copied!
{
"outcome": "review",
"transactionReference": "reference",
"reason": [
"Fraud suspicion"
],
"score": 50.5,
"riskProfile": {
"href": "https://access.worldpay.com/riskProfile/ewogICJ2IiA6IDEsCiAgImsiIDogMSwKICAiZCIgOiAiU1BtQ0VmZXl3WmlQeFJjVkZqQmExZkpyUlBLYkNjRUtyRVlkL25KY1lYeXBQcDVZTmUrTmVGMjRzRjEyb2VGTFRtSkhtcDMwaSsyZE5uOGl3bURVSXMzaDUyNk5jNVNlSU9Ec0dUVzAwYlNneFdVSlpOeEdHZk9GRGZuU0pNYXl6N2Faek9Qc1JFL1Iva01NYkxpNHNiM1d3MlVxSkk1VVRFNXlPYnM2NUpmZGxqWlBkc0FqaHV4cnl0OHFISEgvTi82d1ZTazJwb2t0RnFON2F6Q2RsZkZvdlVGMVl4ZnAvaGlUME1wdVZ1dTFKc2twa1k1OERubnVjNkRVaXphWnhHVUc5SVFNOERkMjNleEhSSzQ2bWpIRk5xY2QvOEFHWDJrcGd3Vk9KeGJ4NFNOUGRNc2NUM0lJdkpQTXBpTHQwWHFMbEUzQmQwOWdPSnJ1R0kyUlIwREdWZ2t6OUFzNjVmaWEwRmU3L2MvZFdBUHI1RHhmTzNDK0ZQWGNJck8rQ28zRDdnUW1mbGZHbzRtR25VTHZnZjFjKzNoSm5xNXpYR2ZoRWh1NWUzM0s3Um0zWVRvTENkR2YvNi9aa2Zyd3JZYzZmWW1HVUpkZjN2VjRJNVB1TkE9PSIKfQ"
}
}
{ "outcome": "review", "transactionReference": "reference", "reason": [ "Fraud suspicion" ], "score": 50.5, "riskProfile": { "href": "https://access.worldpay.com/riskProfile/ewogICJ2IiA6IDEsCiAgImsiIDogMSwKICAiZCIgOiAiU1BtQ0VmZXl3WmlQeFJjVkZqQmExZkpyUlBLYkNjRUtyRVlkL25KY1lYeXBQcDVZTmUrTmVGMjRzRjEyb2VGTFRtSkhtcDMwaSsyZE5uOGl3bURVSXMzaDUyNk5jNVNlSU9Ec0dUVzAwYlNneFdVSlpOeEdHZk9GRGZuU0pNYXl6N2Faek9Qc1JFL1Iva01NYkxpNHNiM1d3MlVxSkk1VVRFNXlPYnM2NUpmZGxqWlBkc0FqaHV4cnl0OHFISEgvTi82d1ZTazJwb2t0RnFON2F6Q2RsZkZvdlVGMVl4ZnAvaGlUME1wdVZ1dTFKc2twa1k1OERubnVjNkRVaXphWnhHVUc5SVFNOERkMjNleEhSSzQ2bWpIRk5xY2QvOEFHWDJrcGd3Vk9KeGJ4NFNOUGRNc2NUM0lJdkpQTXBpTHQwWHFMbEUzQmQwOWdPSnJ1R0kyUlIwREdWZ2t6OUFzNjVmaWEwRmU3L2MvZFdBUHI1RHhmTzNDK0ZQWGNJck8rQ28zRDdnUW1mbGZHbzRtR25VTHZnZjFjKzNoSm5xNXpYR2ZoRWh1NWUzM0s3Um0zWVRvTENkR2YvNi9aa2Zyd3JZYzZmWW1HVUpkZjN2VjRJNVB1TkE9PSIKfQ" } }