Menu

Fraud update

API v1
Coming soon

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": "unique-transactionReference",
  "merchant": {
    "entity": "default"
  },
  "riskProfile": "https://access.worldpay.com/riskprofile/ewogICJ2ZXJzaW9uIiA6IDEsCiAgImtleSIgOiAxLAogICJkYXRhIiA6ICJ5d1NnSzMwYnNGZXVYalR0QUJ0QWdnT3UvK3VhcktrL3c1dCtmSFd4dUFXRmVMZUpuM0MyaEtnYnZlZEdnbGtRY1h4LzltN1pSZGVXZWRBQ1ZvTmxZdFNiZUxaSmFrZXZxenVndFQ2bG44NkpNTW5CeGJSRFVWWWY3dTd5SXVuVFJLK0NYZS9tODRkaHdTUWVnZlYyYTRCb1RaQVNKK0RpcGpmYUxkK1lETlJFclVyZ1c0TGIvOGhvNnFzbFVBU0dSem8zRVRkMEdIUTZXZ1dIT2t1UVBabUF1NXZuVFdBeGZrSEQ5SkdrT1BoV1pMMmIyZm9yNWNOMzZvWUhOY2dkT0lKdkhNMEg5TG1oRDM1RXA4T3R2WWptVmNXS25FZmtLZ0RrK09KRDNLb2pobG",
  "scheme": "Visa",
  "source": "TC40",
  "sourceDate": "2020-12-27T00:00:00Z",
  "acquirer": "Worldpay",
  "acquirerMID": "18777015",
  "acquirerReference": "02691780344910023278387",
  "fraudReasonCode": "5",
  "value": {
    "currency": "GBP",
    "amount": 250
  }
}
ParameterRequiredDescription
transactionReferenceA reference for the assessment. For example, e-commerce order code.
merchant.entityUsed to route the assessment request in Access Worldpay, created as part of on-boarding.
riskProfileRepresents the outcome of the original fraud assessment. Used to link subsequent Fraud related requests.
scheme
  • Visa
  • Mastercard
sourceSource format of confirmed fraud cases:
  • TC40
  • SAFE
sourceDateDate/time of source fraud file (TC40/SAFE).
acquirerPayment acquirer e.g. Barclays, Adyen.
acquirerMIDAcquirer unique identifier for the merchant.
acquirerReferenceAcquirer Reference Number (ARN) - unique value assigned to a credit or debit card transaction.
fraudReasonCodeVisa and Mastercard reason codes.
value.currencyThe three digit currency code.
See list ofsupported currencies.
value.amountThe 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 ourcurrency table.

Fraud update responses

The response status is 200 OK.