Refund

Refund

This documentation provides detailed information on how to process refunds using our API. It includes steps for initiating a refund, required parameters, and handling responses.

Initiating Refund

Endpoint https://api.chapa.co/v1/refund/<chapa_referece>

<chapa_referece> is the reference that was set by chapa when payment is initiated.

Method POST

  • Authorization : Pass your secret key as a bearer token in the request header to authorize this call.

Body Params

ParameterRequiredTypeDescription
reasonyesstringReason for refund
import http.client    conn = http.client.HTTPSConnection("api.chapa.co")  payload = 'reason=accidental purchase'  headers = {    'Content-Type': 'application/x-www-form-urlencoded',    'Authorization': 'Bearer Bearer CHASECK_TEST-xxxxxxxxxxxxxxxx'  }  conn.request("POST", "/v1/refund/APezQ1KKswbb", payload, headers)  res = conn.getresponse()  data = res.read()  print(data.decode("utf-8"))

NB

  • We don’t support partial refunds, so amounts should equal the transaction amount or be left empty; we will take the transaction amount.
  • Chapa charges are non-refundable, which means we take the transaction amount plus charges from the available balance.
  • The refund amount will be deducted from your available balance.
ℹ️
Refer to our Error Codes page for all responses for this request.