When an invoice fails to be paid, you may need to resolve it by either writing it off or recording an external payment. Resolving a failed invoice effectively closes the transaction, preventing further actions on the invoice. Once resolved the associated PayNow link will be disabled, and any retry attempts will result in an error.

It’s important to note that invoice resolution should only occur after all efforts to recollect payment have failed.

There are two primary ways to resolve a failed invoice:

Writing off an invoice

Use the Write Off Invoice API for invoice you no longer wish to attempt to collect payment. This action marks the invoice as WRITTEN_OFF and ends any further attempts to collect payment.

Record an external payment for an invoice

Use the Record External Payment API for any payment collected outside of Ezypay (e.g. cash over the counter). Invoice status is updated to PAID after the action. No invoice_paid webhook event will be triggered by this action. It ensures that the invoice status reflects the actual payment collected, keeping your records accurate.

🚧

Attention

Both actions will reallocate any fees collected by Ezypay back to the merchant. These fees will be deducted during the next settlement.