Create a Refund

Partially or fully initiate a refund on a preauth charge

POST /charges/{flw_ref}/refund

Create a Refund

cURL

curl --request POST \
  --url https://api.flutterwave.com/v3/charges/{flw_ref}/refund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "100"
}
'

200

{
  "status": "success",
  "message": "Charge refunded",
  "data": {
    "id": 4973363,
    "tx_ref": "YOUR_UNIQUE_REFERENCE",
    "flw_ref": "FLW-MOCK-PREAUTH-bde14443c3f233d11c5f574acc120399",
    "device_fingerprint": "N/A",
    "amount": 100,
    "charged_amount": 100,
    "app_fee": 5.8,
    "merchant_fee": 0,
    "processor_response": "Approved",
    "auth_model": "NOAUTH",
    "currency": "NGN",
    "ip": "54.75.161.64",
    "narration": "FLW-PBF CARD Transaction ",
    "status": "successful",
    "auth_url": "N/A",
    "payment_type": "card",
    "plan": null,
    "fraud_status": "ok",
    "charge_type": "preauth",
    "created_at": "2024-03-18T10:18:56.000Z",
    "account_id": 20937,
    "customer": {
      "id": 2373852,
      "phone": null,
      "fullName": "Anonymous customer",
      "customertoken": null,
      "email": "[e-mail]",
      "createdAt": "2024-03-18T10:18:56.000Z",
      "updatedAt": "2024-03-18T10:18:56.000Z",
      "deletedAt": null,
      "AccountId": 20937
    },
    "card": {
      "first_6digits": "537728",
      "last_4digits": "7450",
      "issuer": "MASTERCARD JSB PROBUSINESSBANK CREDITGOLD",
      "country": "RU",
      "type": "MASTERCARD",
      "expiry": "09/31"
    }
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

flw_ref · string · required

Example:

"FLW-MOCK-PREAUTH-bde14443c3f233d11c5f574acc120399"

Body

application/json

amount · string · required

Response

200

application/json; charset=utf-8

OK

status · string · required

message · string · required

data · Data19 · object · required

Show child attributes

Example:

{
  "id": 4973363,
  "tx_ref": "YOUR_UNIQUE_REFERENCE",
  "flw_ref": "FLW-MOCK-PREAUTH-bde14443c3f233d11c5f574acc120399",
  "device_fingerprint": "N/A",
  "amount": 100,
  "charged_amount": 100,
  "app_fee": 5.8,
  "merchant_fee": 0,
  "processor_response": "Approved",
  "auth_model": "NOAUTH",
  "currency": "NGN",
  "ip": "54.75.161.64",
  "narration": "FLW-PBF CARD Transaction ",
  "status": "successful",
  "auth_url": "N/A",
  "payment_type": "card",
  "plan": null,
  "fraud_status": "ok",
  "charge_type": "preauth",
  "created_at": "2024-03-18T10:18:56.000Z",
  "account_id": 20937,
  "customer": {
    "id": 2373852,
    "phone": null,
    "fullName": "Anonymous customer",
    "customertoken": null,
    "email": "[e-mail]",
    "createdAt": "2024-03-18T10:18:56.000Z",
    "updatedAt": "2024-03-18T10:18:56.000Z",
    "deletedAt": null,
    "AccountId": 20937
  },
  "card": {
    "first_6digits": "537728",
    "last_4digits": "7450",
    "issuer": "MASTERCARD JSB PROBUSINESSBANK CREDITGOLD",
    "country": "RU",
    "type": "MASTERCARD",
    "expiry": "09/31"
  }
}