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/<tx_ref>

<tx_ref> is the reference that is provided by the chapa after the payment is initiated.

Method POST

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

Body Params

1import http.client
2  
3  conn = http.client.HTTPSConnection("api.chapa.co")
4  payload = 'reason=accidental purchase&amount=1000&meta[customer_id]=123&meta[reference]=REF123'
5  headers = {
6    'Content-Type': 'application/x-www-form-urlencoded',
7    'Authorization': 'Bearer Bearer CHASECK_TEST-xxxxxxxxxxxxxxxx'
8  }
9  conn.request("POST", "/v1/refund/APezQ1KKswbb", payload, headers)
10  res = conn.getresponse()
11  data = res.read()
12  print(data.decode("utf-8"))

NB - If amount is not provided: We will refund the full 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