Last Updated: 15 February 2023 | Change Log
Chargeback update
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:
{ "transactionReference": "Memory265-13/08/1876", "merchant": { "entity": "MindPalaceLtd" }, "riskProfile": "https://access.worldpay.com/riskprofile/ewogICJ2ZXJzaW9uIiA6IDEsCiAgImtleSIgOiAxLAogICJkYXRhIiA6ICJ5d1NnSzMwYnNGZXVYalR0QUJ0QWdnT3UvK3VhcktrL3c1dCtmSFd4dUFXRmVMZUpuM0MyaEtnYnZlZEdnbGtRY1h4LzltN1pSZGVXZWRBQ1ZvTmxZdFNiZUxaSmFrZXZxenVndFQ2bG44NkpNTW5CeGJSRFVWWWY3dTd5SXVuVFJLK0NYZS9tODRkaHdTUWVnZlYyYTRCb1RaQVNKK0RpcGpmYUxkK1lETlJFclVyZ1c0TGIvOGhvNnFzbFVBU0dSem8zRVRkMEdIUTZXZ1dIT2t1UVBabUF1NXZuVFdBeGZrSEQ5SkdrT1BoV1pMMmIyZm9yNWNOMzZvWUhOY2dkT0lKdkhNMEg5TG1oRDM1RXA4T3R2WWptVmNXS25FZmtLZ0RrK09KRDNLb2pobG", "sourceDate": "2020-12-27T00:00:00Z", "acquirerReference": "02691780344910023278387", "chargebackReasonCode": "31", "chargebackCaseReference": "123456", "chargebackValue": { "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. |
sourceDate | ✅ | Date/time of source fraud file (TC40/SAFE). |
acquirerReference | ✅ | Acquirer Reference Number (ARN) - unique value assigned to a credit or debit card transaction. |
chargebackReasonCode | ✅ | Visa and Mastercard reason codes. |
chargebackCaseReference | ✅ | Case reference for a specific chargeback. |
chargebackValue.currency | ✅ | The three digit currency code. See list of supported currencies. |
chargebackValue.amount | ✅ | The 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 our currency table. |
Chargeback 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
.