**Last updated**: 30 September 2025 | [**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-bsh.securedataplatform.com/fraudsight/update/chargeback`

Chargeback update request body:

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