Subscription Settings
Configure retry policies, dunning, and notifications
Subscription settings control how Edge handles recurring payment collection, failed retries, and notifications. Access via the Subscriptions tab in Operations > Edge > Settings.
Subscription Configuration
Retry Policy
object
optional
How Edge handles failed subscription payments. Includes: number of retry attempts (default: 3), delay between retries (default: 3 days), and whether to notify the subscriber on each retry.
Grace Period
integer
optional
Days after a failed final retry before the subscription is cancelled. During grace, the subscriber retains access but is notified to update their payment method.
Default: 7
Cancellation Behavior
enum
optional
What happens on cancellation: immediate (access ends now) or end_of_period (access continues until current cycle ends).
Subscriber Notifications
object
optional
Email notifications during the lifecycle: payment receipt, upcoming renewal, failed payment, grace period warning, and cancellation confirmation.
Proration
boolean
optional
Whether to calculate prorated charges when a subscription changes mid-cycle (upgrade or downgrade).
Default: 1
