Update a chargeback

Accept/Decline Chargebacks

curl --request PUT \
  --url https://api.flutterwave.com/v3/chargebacks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "accept",
  "comment": "testing...",
  "prooflink": "https//www.example.com/prooflink"
}
'

import requests

url = "https://api.flutterwave.com/v3/chargebacks/{id}"

payload = {
    "action": "accept",
    "comment": "testing...",
    "prooflink": "https//www.example.com/prooflink"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    action: 'accept',
    comment: 'testing...',
    prooflink: 'https//www.example.com/prooflink'
  })
};

fetch('https://api.flutterwave.com/v3/chargebacks/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/chargebacks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'action' => 'accept',
    'comment' => 'testing...',
    'prooflink' => 'https//www.example.com/prooflink'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/chargebacks/{id}"

	payload := strings.NewReader("{\n  \"action\": \"accept\",\n  \"comment\": \"testing...\",\n  \"prooflink\": \"https//www.example.com/prooflink\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.flutterwave.com/v3/chargebacks/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"action\": \"accept\",\n  \"comment\": \"testing...\",\n  \"prooflink\": \"https//www.example.com/prooflink\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/chargebacks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"action\": \"accept\",\n  \"comment\": \"testing...\",\n  \"prooflink\": \"https//www.example.com/prooflink\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Chargeback accepted",
  "data": {
    "id": 1591,
    "amount": 100,
    "flw_ref": "FLW-MOCK-3cc9bbe84a82eb054191d1a1a609909b",
    "status": "accepted",
    "stage": "new",
    "comment": "Testing Testing",
    "due_date": "2024-03-27T15:59:59.000Z",
    "settlement_id": "N/A",
    "created_at": "2024-03-26T12:12:12.000Z",
    "meta": {
      "uploaded_proof": null,
      "history": [
        {
          "action": "initiated",
          "stage": "new",
          "date": "2024-03-26T12:15:06.000Z",
          "description": "Debit and hold chargeback amount"
        },
        {
          "action": "notification",
          "date": "2024-03-26T12:15:19.000Z",
          "description": "Email Notification Sent"
        },
        {
          "action": "accept",
          "stage": "new",
          "date": "2024-03-27T10:07:43.000Z",
          "description": "Merchant accepts claim"
        }
      ]
    }
  }
}

{
  "status": "error",
  "message": "Error: Chargeback due time has passed",
  "data": null
}

PUT

chargebacks

{id}

Accept/Decline Chargebacks

curl --request PUT \
  --url https://api.flutterwave.com/v3/chargebacks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "accept",
  "comment": "testing...",
  "prooflink": "https//www.example.com/prooflink"
}
'

import requests

url = "https://api.flutterwave.com/v3/chargebacks/{id}"

payload = {
    "action": "accept",
    "comment": "testing...",
    "prooflink": "https//www.example.com/prooflink"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    action: 'accept',
    comment: 'testing...',
    prooflink: 'https//www.example.com/prooflink'
  })
};

fetch('https://api.flutterwave.com/v3/chargebacks/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/chargebacks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'action' => 'accept',
    'comment' => 'testing...',
    'prooflink' => 'https//www.example.com/prooflink'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/chargebacks/{id}"

	payload := strings.NewReader("{\n  \"action\": \"accept\",\n  \"comment\": \"testing...\",\n  \"prooflink\": \"https//www.example.com/prooflink\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.flutterwave.com/v3/chargebacks/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"action\": \"accept\",\n  \"comment\": \"testing...\",\n  \"prooflink\": \"https//www.example.com/prooflink\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/chargebacks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"action\": \"accept\",\n  \"comment\": \"testing...\",\n  \"prooflink\": \"https//www.example.com/prooflink\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Chargeback accepted",
  "data": {
    "id": 1591,
    "amount": 100,
    "flw_ref": "FLW-MOCK-3cc9bbe84a82eb054191d1a1a609909b",
    "status": "accepted",
    "stage": "new",
    "comment": "Testing Testing",
    "due_date": "2024-03-27T15:59:59.000Z",
    "settlement_id": "N/A",
    "created_at": "2024-03-26T12:12:12.000Z",
    "meta": {
      "uploaded_proof": null,
      "history": [
        {
          "action": "initiated",
          "stage": "new",
          "date": "2024-03-26T12:15:06.000Z",
          "description": "Debit and hold chargeback amount"
        },
        {
          "action": "notification",
          "date": "2024-03-26T12:15:19.000Z",
          "description": "Email Notification Sent"
        },
        {
          "action": "accept",
          "stage": "new",
          "date": "2024-03-27T10:07:43.000Z",
          "description": "Merchant accepts claim"
        }
      ]
    }
  }
}

{
  "status": "error",
  "message": "Error: Chargeback due time has passed",
  "data": null
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Body

application/json

action

string

required

comment

string

required

prooflink

string

required

Response

status

string

required

message

string

required

data

Data95 · object

required

Show child attributes

Example:

{
  "id": 1591,
  "amount": 100,
  "flw_ref": "FLW-MOCK-3cc9bbe84a82eb054191d1a1a609909b",
  "status": "accepted",
  "stage": "new",
  "comment": "Testing Testing",
  "due_date": "2024-03-27T15:59:59.000Z",
  "settlement_id": "N/A",
  "created_at": "2024-03-26T12:12:12.000Z",
  "meta": {
    "uploaded_proof": null,
    "history": [
      {
        "action": "initiated",
        "stage": "new",
        "date": "2024-03-26T12:15:06.000Z",
        "description": "Debit and hold chargeback amount"
      },
      {
        "action": "notification",
        "date": "2024-03-26T12:15:19.000Z",
        "description": "Email Notification Sent"
      },
      {
        "action": "accept",
        "stage": "new",
        "date": "2024-03-27T10:07:43.000Z",
        "description": "Merchant accepts claim"
      }
    ]
  }
}

API Documentation

Charges

Tokenized Charges

Preauthorization

Transactions

Transfers

Beneficiaries

Virtual Cards

Virtual Account Numbers

Collection Subaccounts

Payout Subaccounts

Subscriptions

Payment Plans

Bill Payments

Banks

Misc

Settlements

Otps

Chargebacks

Authorizations

Path Parameters

Body

Response