Bill Events
A bill can have one of three statuses, which change based on payment or billing events:
Paid
The status changes to paid when the total amount paid across all payments exceeds the bill’s value.
Pending
Pending is the initial status of a newly created bill. A bill can also revert to pending from paid or canceled under specific circumstances:
- Partial Refund: If a partial refund is issued, the bill returns to pending.
- Charge Cancellation: If a charge is canceled and then reinstated, the bill status changes from canceled to pending.
Canceled
A bill is marked as canceled primarily due to an event from the parent entity (billing). To understand the reasons behind the cancellation, refer to billing.cancellation_reason. Common reasons include:
- Refund of the first bill.
- The first bill was unpaid, leading to the cancellation of subsequent bills.