---
title: "Create a refund"
method: POST
path: "/refunds"
tags: ["Refunds"]
---

# Create a refund

`POST /refunds`

Create a refund

## Headers

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

## Request body

- RefundIn — A refund of a previously created charge
  - `amount` number, required — The payment amount in decimals.
  - `charge_id` string, required — ID of the charge to refund
  - `meta` Meta
  - `reason` 'duplicate' | 'fraudulent' | 'requested_by_customer' | 'expired_uncaptured_charge', required — Reason for the refund

## Response `201`

OK

- object
  - `status` 'success' | 'failed'
  - `message` string
  - `data` Refund — A refund of a previously created charge
    - `id` string — ID of the refund
    - `amount_refunded` number — The payment amount in decimals.
    - `meta` Meta
    - `reason` 'duplicate' | 'fraudulent' | 'requested_by_customer' | 'expired_uncaptured_charge' — Reason for the refund
    - `status` 'pending' | 'requires_action' | 'succeeded' | 'failed' | 'cancelled' | 'completed' | 'new' — Status of the refund
    - `charge_id` string — ID of the charge tied to this refund
    - `created_datetime` string

## Other responses

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

---

[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)