Invoice Management Process

The Invoice Management Process is divided into three key sections: display invoice history, future invoices management and up-to-date invoice status. This is essential for providing merchants with a holistic view of past and future billing activities.

Important Items

Displaying History of Past Invoices
Displays all attempted invoices, including their status, amount, and date. If an invoice fails, display the failure reason. This gives merchants a comprehensive overview of billing activities and collected payments. The failure reason is crucial for quick troubleshooting and recollection.

Display and Editing Future Invoices
Note: only applicable to partners using the subscription model.
With the subscription model, Ezypay manages the billing schedule and amount. Therefore, it is important to show merchants information about future invoices and allow them to update future invoices. This provides more visibility and control to merchants/customers over upcoming payments.

Keeping Invoice Status Up to Date
Use invoice status webhook events to update the invoice status in real-time. This ensures immediate action can be taken by your system or the merchants based on the latest status. This is important for subscription model integration because invoice is generated automatically by Ezypay at backend and without webhook you would not know an invoice exist.

Please note: bank transactions have 3-day holding period during which the invoice status will be “PROCESSING”. The final status will be returned to you in 3 business days’ time. The same logic applies to refunds to a bank account. The invoice status will be update to “PROCESSING” and the final refund status will be known after 3 business days. Use webhook events to identify the latest update to invoice status.