---
title: "Update a chargeback"
method: PUT
path: "/chargebacks/{id}"
tags: ["Chargebacks"]
---

# Update a chargeback

`PUT /chargebacks/{id}`

Update a chargeback

## Path parameters

- `id` string, required — ID of the chargeback

## Headers

- `X-Trace-Id` string

## Request body

- ChargebackUpdateIn
  - `status` 'accepted' | 'declined' — The status indicates the final resolution of a dispute or request, showing whether it has been accepted or declined.
  - `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
  - `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.
  - `proof_data` string — Base64 encoded string of proof against chargeback

## Response `200`

OK

- object
  - `status` 'success' | 'failed'
  - `message` string
  - `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)