Refunds
Ezypay simplifies refund processing by deducting the refund amount from the merchant's wallet and crediting it back to the original payment method. Below is an overview of the types of refunds supported, prerequisites, and best practices.
Ezypay supports the following refund types:
- Full invoice amount
- Individual invoice items
- Partial amount of an invoice
- Partial amount of individual invoice items
Note
- Ezypay will only refund fees for FULL refunds.
- Partial refunds or item-specific refunds are not eligible for fee refunds.
Pre-requisites
Invoice status
Only invoices with a status of PAID or PARTIALLY_REFUNDED are eligible for refunds. Ensure the invoice meets this criterion before proceeding.
Insufficient funds in the merchant's wallet
Refunds will fail if the merchant's wallet has insufficient funds. Retry the refund once the wallet has an adequate balance.
Get started
Use Refunds API to initiate a refund request with Ezypay.
- Provide the
invoiceIdas the API URL parameters. - Set up a webhook to track refund outcomes.
credit_note_paid- Refund success.credit_note_failedRefund failed.
Best practice
Beware of invoice status changed
Refund actions update the invoice and credit note statuses. Ensure your system accommodates these changes to maintain accurate tracking.
| Scenario | Invoice Status | Credit Note Status | Webhook events triggered |
|---|---|---|---|
| Refund initiated | PAID>PROCESSING | N/A >PROCESSING | credit_note_created |
| Refund success | PROCESSING>REFUNDED / PARTIALLY_REFUNDED | PROCESSING>PAID | credit_note_paid |
| Refund fail | PROCESSING>PAID | PROCESSING>FAILED | credit_note_failed |
NoteRefunds to a bank account may take up to 3 business days to process.
Updated 5 days ago