Last Updated: 15 February 2023 | Change Log
Fraud update
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:
{ "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 supported currencies. |
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 currency table. |
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
.