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 reaches or 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.cancelation_reason. Common reasons include:
- Refund of the first bill.
- The first bill was unpaid, leading to the cancellation of subsequent bills.
Overdue
In this state, the bill is still in pending status, however, the effective_due_date has already passed the current date. The event is sent once, at the beginning of the day after the effective_due_date, for pending installment bills of active financed billings (not for down payments or upfront orders). It is not sent in the sandbox environment.