Billing Customer Statuses
What each status means and when transitions happen
Every billing customer in Edge has a status that determines what billing actions are available. This reference covers all three statuses and the transitions between them.
Billing Customer Statuses
pending
— The billing customer record exists but the initial verification charge has not been completed. Trigger enrollments cannot be activated. Invoices can still be sent to the contact, but trigger billing and subscriptions require an active status. Transitions to `active` when the initial charge succeeds, or immediately on creation if `bc_require_initial` is set to false.
active
— The billing customer is fully operational. All billing modes are available: invoices can be sent and paid, subscriptions can be created, and trigger enrollments can be activated and fired. This is the normal working state.
suspended
— All billing activity is paused. Active trigger enrollments are frozen — they retain their status but triggers will not fire. Pay Now links on outstanding invoices are disabled. New enrollments cannot be created. Transitions back to `active` via the Restore action. No data is deleted during suspension.
Status Transitions
| From | To | Triggered By |
|---|---|---|
| pending | active | Initial charge succeeds, or initial charge not required |
| active | suspended | Admin clicks Suspend or API call to suspendCustomer.php |
| suspended | active | Admin clicks Restore or API call to restoreCustomer.php |
Tip:
You can check a billing customer's status via the API using `getCustomer.php`. The `bc_status` field returns `pending`, `active`, or `suspended`.
