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:

  1. Full invoice amount
  2. Individual invoice items
  3. Partial amount of an invoice
  4. 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.

  1. Provide the invoiceId as the API URL parameters.
  2. Set up a webhook to track refund outcomes.
    1. credit_note_paid - Refund success.
    2. 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.

ScenarioInvoice StatusCredit Note StatusWebhook events triggered
Refund initiatedPAID>PROCESSINGN/A >PROCESSINGcredit_note_created
Refund successPROCESSING>REFUNDED / PARTIALLY_REFUNDEDPROCESSING>PAIDcredit_note_paid
Refund failPROCESSING>PAIDPROCESSING>FAILEDcredit_note_failed

📘

Note

Refunds to a bank account may take up to 3 business days to process.