A bill formalizes a payment request from the client. It details important information such as the payment method, the amount due, and the current status of the payment. Bills follow a lifecycle reflected by different statuses:
Bill Statuses
Paid: Indicates that the client has successfully made the payment. This status is accompanied by a corresponding transaction record, confirming the completion of the billing process.
Draft: A preliminary invoice that is still under internal review or editing. Draft bills have not yet been finalized or sent to the client and do not trigger any payment requests.
Retrying: The system adopts this status when an initial payment attempt fails. Automated retries are scheduled to process the payment, and the system may apply additional recovery techniques like payment method updates or reminders.
Pending: Represents a bill that is awaiting further action or approval before it can be processed. This status can occur when a manual review, approval, or client confirmation is needed.
Expired: This status applies when the billing period has passed without the payment being completed. No further payment attempts will be made, and the bill is considered invalid for future payment unless reissued.
Overdue: Indicates that the payment is past its due date. In this state, the bill is still valid but requires immediate attention, and the client may face late fees or account limitations if not resolved.
There is a specific type of bill known as a refunded bill. These bills reference another bill, indicating that the first bill's amount will be refunded.
A bill is always linked to a contract.