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
invoiceId
as the API URL parameters. - Set up a webhook to track refund outcomes.
credit_note_paid
- Refund success.credit_note_failed
Refund 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 |
Note
Refunds to a bank account may take up to 3 business days to process.
Updated 30 days ago