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
Parameter | Required | Type | Description |
---|---|---|---|
reason | yes | string | Reason 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.