---
title: "Create a chargeback"
method: POST
path: "/chargebacks"
tags: ["Chargebacks"]
---

# Create a chargeback

`POST /chargebacks`

## Headers

- `X-Trace-Id` string
- `X-Idempotency-Key` string

## Request body

- ChargebackIn — A chargeback input object
  - `charge_id` string, required — ID of the charge tied to this chargeback
  - `amount` number, required — The payment amount in decimals.
  - `stage` 'new' | 'second' | 'pre-arbitration' | 'arbitration' — The stage describes the current phase of a chargeback dispute.
  - `status` 'pending' | 'initiated' — The status indicates the current state or progress of the chargeback, showing whether it's awaiting action or has been formally started.
  - `type` 'local' | 'international', required — The type categorizes the chargeback based on whether it originates from a transaction within the same country (local) or across different countries (international).
  - `uploaded_proof` string — Link to proof against chargeback
  - `comment` string — Additional comments for the chargeback
  - `provider` string — Provider for the chargeback
  - `arn` string — Acquirer reference number for transaction
  - `initiator` string — Initiator of the chargeback
  - `expiry` integer, required — Duration of chargeback in hours used in calculating due_datetime

## Response `201`

OK

- object
  - `status` 'success' | 'failed'
  - `message` string
  - `meta` object
  - `data` Chargeback — A chargeback object
    - `id` string — ID of the chargeback
    - `charge_id` string — ID of the charge tied to this chargeback
    - `amount` number — The payment amount in decimals.
    - `meta` Meta
    - `stage` 'new' | 'second' | 'pre-arbitration' | 'arbitration' | 'invalid' — The stage describes the current phase of a chargeback dispute
    - `status` 'pending' | 'accepted' | 'declined' | 'initiated' | 'won' | 'lost' | 'reversed' | 'new' — The status field tracks the current state or outcome of a chargeback dispute, providing a comprehensive overview of its lifecycle.
    - `type` 'local' | 'international' — The type categorizes the chargeback based on whether it originates from a transaction within the same country (local) or across different countries (international).
    - `due_datetime` string, date-time — The due_datetime specifies the exact date and time by which an action or response is required. This is typically used to set deadlines for submitting documentation or responding to a chargeback.
    - `created_datetime` string, date-time — The created_datetime indicates the exact date and time when the chargeback record was initially created in the system. This timestamp helps in tracking the age of the dispute.
    - `updated_datetime` string, date-time — The updated_datetime specifies the most recent date and time when any information related to the chargeback record was modified or updated. This helps in tracking the last activity on the dispute.
    - `settlement_id` string — ID of the settlement tied to this chargeback
    - `uploaded_proof` string — Link to proof against chargeback
    - `comment` string — Additional comments for the chargeback
    - `provider` string — Provider for the chargeback
    - `arn` string — Acquirer reference number for transaction
    - `initiator` string — Initiator of the chargeback

## Other responses

- `400` — Bad request
- `401` — Unauthorised request
- `403` — Forbidden

---

[API](https://skmtc.net/flutterwave/apis/flutterwave-apis.md) · [All operations](https://skmtc.net/flutterwave/apis/flutterwave-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flutterwave/flutterwave-apis/revisions/6014190df2e9/schema)