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

ParameterRequiredTypeDescription
reasonyesstringReason for refund
amountnostringAmount to refund. If not provided, the full transaction amount will be refunded
metanoobjectAdditional metadata that will be returned in the response and webhook. Can contain any custom key-value pairs
referencenostringA unique identifier for this refund request. Must be unique within your business.
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

ℹ️

Refer to our Error Codes page for all responses for this request.

Fraud PreventionRoles & Permissions