Fraud update
Note: This API is for preview purposes only and is subject to change.
POST your request to the fraudsight:fraud action link.
Fraud update example request
POST https://try.access.worldpay.com/fraudsight/update/fraud
Fraud update request body:
Copied!
{
"transactionReference": "Memory265-13/08/1876",
"merchant": {
"entity": "MindPalaceLtd"
},
"riskProfile": "https://access.worldpay.com/riskprofile/ewogICJ2ZXJzaW9uIiA6IDEsCiAgImtleSIgOiAxLAogICJkYXRhIiA6ICJ5d1NnSzMwYnNGZXVYalR0QUJ0QWdnT3UvK3VhcktrL3c1dCtmSFd4dUFXRmVMZUpuM0MyaEtnYnZlZEdnbGtRY1h4LzltN1pSZGVXZWRBQ1ZvTmxZdFNiZUxaSmFrZXZxenVndFQ2bG44NkpNTW5CeGJSRFVWWWY3dTd5SXVuVFJLK0NYZS9tODRkaHdTUWVnZlYyYTRCb1RaQVNKK0RpcGpmYUxkK1lETlJFclVyZ1c0TGIvOGhvNnFzbFVBU0dSem8zRVRkMEdIUTZXZ1dIT2t1UVBabUF1NXZuVFdBeGZrSEQ5SkdrT1BoV1pMMmIyZm9yNWNOMzZvWUhOY2dkT0lKdkhNMEg5TG1oRDM1RXA4T3R2WWptVmNXS25FZmtLZ0RrK09KRDNLb2pobG",
"source": "TC40",
"sourceDate": "2020-12-27T00:00:00Z",
"acquirerReference": "02691780344910023278387",
"fraudReasonCode": "5",
"value": {
"currency": "GBP",
"amount": 250
}
}{ "transactionReference": "Memory265-13/08/1876", "merchant": { "entity": "MindPalaceLtd" }, "riskProfile": "https://access.worldpay.com/riskprofile/ewogICJ2ZXJzaW9uIiA6IDEsCiAgImtleSIgOiAxLAogICJkYXRhIiA6ICJ5d1NnSzMwYnNGZXVYalR0QUJ0QWdnT3UvK3VhcktrL3c1dCtmSFd4dUFXRmVMZUpuM0MyaEtnYnZlZEdnbGtRY1h4LzltN1pSZGVXZWRBQ1ZvTmxZdFNiZUxaSmFrZXZxenVndFQ2bG44NkpNTW5CeGJSRFVWWWY3dTd5SXVuVFJLK0NYZS9tODRkaHdTUWVnZlYyYTRCb1RaQVNKK0RpcGpmYUxkK1lETlJFclVyZ1c0TGIvOGhvNnFzbFVBU0dSem8zRVRkMEdIUTZXZ1dIT2t1UVBabUF1NXZuVFdBeGZrSEQ5SkdrT1BoV1pMMmIyZm9yNWNOMzZvWUhOY2dkT0lKdkhNMEg5TG1oRDM1RXA4T3R2WWptVmNXS25FZmtLZ0RrK09KRDNLb2pobG", "source": "TC40", "sourceDate": "2020-12-27T00:00:00Z", "acquirerReference": "02691780344910023278387", "fraudReasonCode": "5", "value": { "currency": "GBP", "amount": 250 } }
| Parameter | Required | Description |
|---|---|---|
transactionReference | A reference for the assessment. For example, e-commerce order code. | |
merchant.entity | Used to route the assessment request in Access Worldpay, created as part of on-boarding. | |
riskProfile | Represents the outcome of the original fraud assessment. Used to link subsequent Fraud related requests. | |
source | Source format of confirmed fraud cases:
| |
sourceDate | Date/time of source fraud file (TC40/SAFE). | |
acquirerReference | Acquirer Reference Number (ARN) - unique value assigned to a credit or debit card transaction. | |
fraudReasonCode | Visa and Mastercard reason codes. | |
value.currency | The three digit currency code. See list of | |
value.amount | The payment amount. This is a whole number with an exponent e.g. if exponent is two, 250 is 2.50. You can find the relevant exponent in our |
Fraud update responses
Best Practice: Access Worldpay returns a WP-CorrelationId in the headers of service responses. We highly recommend you log this. The WP-CorrelationId is used by us to examine individual service requests.
The response status is 200 OK.
