---
title: "Create a chargeback [Early Access]"
method: POST
path: "/payments/{paymentId}/chargeback"
---

# Create a chargeback \[Early Access\]

`POST /payments/{paymentId}/chargeback`

## Request

- Base URL: `https://api.sandbox.cleeng.com/3.1`
- URL: `https://api.sandbox.cleeng.com/3.1/payments/{paymentId}/chargeback`
- Auth: API key in header `X-Publisher-Token`

**Please note that this an [Early Access](https://publisher.support.cleeng.com/hc/en-us/articles/10037994501532-Early-Access-Features) phase.** <br><br> Use this endpoint to record a chargeback for a specific payment via the payment connector. The payment connector calls it when the payment gateway (e.g. Adyen) reports a dispute for a payment. <br><br> It supports two stages of chargebacks: <br> - `first` – records a first chargeback (initial dispute). For Cleeng-managed subscriptions, a refund is triggered if the payment has not already been refunded. <br> - `second` – records a second chargeback (dispute lost). No refund is triggered, and a first chargeback must already exist for the same payment. <br><br> Each stage can be recorded only once per payment; a duplicate request for the same stage is rejected.

## Path parameters

- `paymentId` integer, required

## Headers

- `Content-Type` string

## Request body

- object
  - `type` string, required: The stage of the chargeback. Accepted values: `first` (initial dispute) or `second` (dispute lost).
  - `occurredAt` integer, required: The exact time the dispute event occurred at the payment gateway (currently supported: Adyen), represented as a positive Unix timestamp in seconds.
  - `externalId` string: An external reference for the dispute (e.g. an Adyen dispute ID). Maximum length: 64 characters.

## Response `201`

Created

- object

## Other responses

- `422`: 422

---

[API](https://skmtc.dev/cleeng/apis/api-31.md) - [All operations](https://skmtc.dev/cleeng/apis/api-31/llms.txt) - [OpenAPI document](https://skmtc.dev/cleeng/apis/api-31/revisions/df55396cda4f?raw)