Trigger Billing Settings
Configuration options for trigger billing behavior
Edge stores trigger billing settings per account. These control global behavior — cooldown windows, failure thresholds, charge limits, and default capture mode. Access them via the Trigger Billing tab in Operations > Edge > Settings.
Trigger Billing Settings
trigger_cooldown_secs
integer
optional
Idempotency window in seconds. If the same billing customer + billable item fires within this window and the previous charge is pending or succeeded, Edge returns the existing result instead of creating a new charge. Prevents double-charging.
Default: 60
max_consecutive_failures
integer
optional
Number of consecutive failed charges before Edge auto-pauses the enrollment. When reached, status changes to paused and a trigger.enrollment.paused webhook fires.
Default: 3
min_initial_charge
decimal
optional
Minimum amount for the initial verification charge when creating a billing customer with bc_require_initial = true. Individual billing customers can set a higher amount.
Default: 15
max_capture_default
decimal
optional
Default maximum capture amount for trigger charges when bi_max_capture_amount is not set on the billable item. Platform-wide safety cap.
Default: 500
default_capture_mode
enum
optional
Default capture mode pre-selected when creating new trigger billable items. Options: off_session or client_confirm. Each item can override this.
Default: off_session
