Managing Trigger Enrollments
Control the lifecycle of trigger billing enrollments
Trigger enrollments connect a billing customer to a specific billable item. Once enrolled, the customer can be charged on-demand via the API or UI. This guide covers every stage of the enrollment lifecycle: enrolling, pausing, resuming, cancelling, switching tiers, and understanding the auto-pause safety mechanism.
Steps
Open the Billing Customer
Navigate to Operations > Edge > Billing Customers and open the customer you want to manage.
Create an Enrollment
In the Enrollments section, click Enroll. Select a trigger billable item from the list. Review the item description and pricing terms. Click Confirm. The enrollment status is set to `active` immediately.
Pause an Enrollment
Click the pause icon next to the enrollment. The status changes to `paused`. While paused, triggers will not fire for this enrollment. Use this for temporary holds or while investigating payment issues.
Resume a Paused Enrollment
Click the resume icon on a paused enrollment. The status returns to `active` and the consecutive failure counter resets to `0`.
Cancel an Enrollment
Click the cancel icon. The status changes to `cancelled`. This is permanent — cancelled enrollments cannot be reactivated. Edge fires a `trigger.enrollment.cancelled` webhook. To re-enroll, create a new enrollment.
Switch Tiers
There is no "edit enrollment" action — the billable item defines the pricing terms. To switch tiers, cancel the current enrollment and create a new one with a different item.
Monitor Health
Check the Last Triggered, Last Charge Status, and Consecutive Failures fields on each enrollment. These tell you when the last charge fired, whether it succeeded, and how many failures have occurred in a row.
Understand Auto-Pause
After 3 consecutive charge failures (configurable), Edge automatically pauses the enrollment and fires a `trigger.enrollment.paused` webhook. Update the customer's payment method first, then resume the enrollment. The failure counter resets on resume.
Result
You can manage the full lifecycle of trigger enrollments: enroll, pause, resume, cancel, and switch items.
