**Last updated**: 16 July 2026 | [**Change log**](/products/fraudsight/changelog/)

# 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:

```shell curl
curl -i -X POST \
  https://try.access.worldpay.com/fraudsight/update/chargeback \
  -H 'Accept: application/vnd.worldpay.fraudsight-v1.hal+json' \
  -H 'Content-Type: application/vnd.worldpay.fraudsight-v1.hal+json' \
  -d '{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
      "entity": "default"
    },
    "riskProfile": "https://access.worldpay.com/riskprofile/ewogICJ2ZXJzaW9uIiA6IDEsCiAgImtleSIgOiAxLAogICJkYXRhIiA6ICJ5d1NnSzMwYnNGZXVYalR0QUJ0QWdnT3UvK3VhcktrL3c1dCtmSFd4dUFXRmVMZUpuM0MyaEtnYnZlZEdnbGtRY1h4LzltN1pSZGVXZWRBQ1ZvTmxZdFNiZUxaSmFrZXZxenVndFQ2bG44NkpNTW5CeGJSRFVWWWY3dTd5SXVuVFJLK0NYZS9tODRkaHdTUWVnZlYyYTRCb1RaQVNKK0RpcGpmYUxkK1lETlJFclVyZ1c0TGIvOGhvNnFzbFVBU0dSem8zRVRkMEdIUTZXZ1dIT2t1UVBabUF1NXZuVFdBeGZrSEQ5SkdrT1BoV1pMMmIyZm9yNWNOMzZvWUhOY2dkT0lKdkhNMEg5TG1oRDM1RXA4T3R2WWptVmNXS25FZmtLZ0RrK09KRDNLb2pobG",
    "sourceDate": "2020-12-27T00:00:00Z",
    "acquirerReference": "02691780344910023278387",
    "chargebackReasonCode": "31",
    "chargebackCaseReference": "123456",
    "chargebackValue": {
      "currency": "GBP",
      "amount": 250
    }
  }'
```

## Schema

Full [API Reference here](/products/fraudsight/openapi)

```json
{
  "$ref": "#/components/schemas/fraudsight_updateChargeback",
  "components": {
    "schemas": {
      "transactionReference": {
        "maxLength": 64,
        "minLength": 1,
        "pattern": "^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$",
        "type": "string",
        "description": "A unique reference for authentication. For example, e-commerce order code."
      },
      "entity": {
        "maxLength": 64,
        "minLength": 1,
        "pattern": "^[A-Za-z0-9 ]*$",
        "type": "string",
        "description": "Used to route the request in Access Worldpay, created as part of on-boarding."
      },
      "fraudsight_updateChargeback": {
        "required": [
          "transactionReference",
          "merchant",
          "riskProfile",
          "sourceDate",
          "acquirerReference",
          "chargebackReasonCode",
          "chargebackCaseReference",
          "chargebackValue"
        ],
        "type": "object",
        "properties": {
          "transactionReference": {
            "$ref": "#/components/schemas/transactionReference"
          },
          "merchant": {
            "required": [
              "entity"
            ],
            "type": "object",
            "description": "An object that contains information about the merchant and API level configuration.",
            "properties": {
              "entity": {
                "$ref": "#/components/schemas/entity"
              }
            }
          },
          "riskProfile": {
            "maxLength": 2048,
            "minLength": 39,
            "type": "string",
            "format": "uri",
            "description": "Represents the outcome of the original fraud assessment. Used to link subsequent fraud related requests."
          },
          "sourceDate": {
            "maxLength": 20,
            "type": "string",
            "format": "date-time",
            "description": "Date/time of source fraud file (TC40/SAFE)."
          },
          "acquirerReference": {
            "maxLength": 128,
            "minLength": 1,
            "type": "string",
            "description": "Acquirer Reference Number (ARN) - unique value assigned to a credit or debit card transaction."
          },
          "chargebackReasonCode": {
            "maxLength": 4,
            "minLength": 2,
            "type": "string",
            "description": "Visa and Mastercard reason codes."
          },
          "chargebackCaseReference": {
            "maxLength": 64,
            "minLength": 1,
            "type": "string",
            "description": "Case reference for a specific chargeback."
          },
          "chargebackValue": {
            "required": [
              "amount",
              "currency"
            ],
            "type": "object",
            "description": "Object containing value of the chargeback transaction.",
            "properties": {
              "amount": {
                "maximum": 999999999,
                "minimum": 0,
                "type": "integer",
                "description": "The chargeback amount. This is a whole number with an exponent, e.g. if exponent is two, 250 is 2.50."
              },
              "currency": {
                "maxLength": 3,
                "minLength": 3,
                "pattern": "^[A-Z]{3}$",
                "type": "string",
                "description": "The three digit currency code."
              }
            }
          }
        }
      }
    }
  }
}
```

## 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`.