Menu

Chargeback update

API v1
Coming soon

Note: This API is for preview purposes only and is subject to change.

POST your request to the fraudsight:chargeback action link.

Chargeback update example request

POST https://try.access.worldpay.com/fraudsight/update/chargeback

Chargeback 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",
  "chargebackReasonCode": "31",
  "chargebackCaseReference": "123456",
  "chargebackValue": {
    "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.
chargebackReasonCodeVisa and Mastercard reason codes.
chargebackCaseReferenceCase reference for a specific chargeback.
chargebackValue.currencyThe three digit currency code.
See list ofsupported currencies.
chargebackValue.amountThe chargeback 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.

Chargeback update responses

The response status is 200 OK.