Overview
The refund API allows you to reverse transactions in part or in full, providing flexibility and control when handling customer requests, errors, or operational reversals.How It Works
When a transaction is successfully completed, you can initiate a refund by making a request to the refund API. To process the refund efficiently, follow these steps:1
Authenticate Your Request
Include your Secret Key in the
Authorization header to securely authenticate the refund request.2
Provide the Order Reference
Use the unique
reference associated with the transaction you want to refund.3
Add Optional Details
You may include additional context for the refund using either the
customer_note or merchant_note field.4
Process a Full or Partial Refund
- Full Refund: Refunds the entire transaction amount.
- Partial Refund: Refunds a portion of the total amount, useful when customers return only part of an order or when a service is partially fulfilled.
Partial Refunds Explained
A partial refund allows you to return only a portion of the original payment instead of the full amount. This is ideal for scenarios like:- A customer cancels one item in a multi-item order.
- A service was only partially delivered.
- You want to retain a processing or cancellation fee.
Refunds
Initiate a Refund
Request
Its important to note that amount cannot be greater than the original transaction amount.
Refund Response
Check Refund Status
Response
Use the
refundReference returned when the refund was initiated, not the original transaction reference.