Plan Trial & Grace Periods
Configure free trials and payment grace periods to improve customer acquisition and reduce churn.Key Benefits#
Customer Acquisition - Free trials reduce barriers to subscription signup
Payment Recovery - Grace periods prevent subscription loss due to temporary payment issues
Reduced Churn - Automated retry logic maintains customer relationships during payment problems
Free Trial#
Offer customers free access before billing begins. After the trial ends, subscription and payments start automatically.Trial Duration - Length of free access period
Trial Unit - Time measurement (days, weeks, months)
Set to 0 to disable free trials
Grace Period#
Define how long to retry failed payments before suspending subscriptions. The system attempts payment once daily during the grace period.Grace Period - Number of retry attempts before suspension
Grace Period Unit - Time measurement for retry intervals
Customers maintain access during grace period
Plan Summary Preview#
The system shows how trials and grace periods affect the subscription:Free Trial - Duration before billing starts
Grace Period - Payment retry window before suspension
Status - Current plan activation state
Customer Usage#
Common Use Cases: Display trial information during signup, communicate grace period policies, show trial remaining time to customers, handle trial-to-paid conversions.Retrieve plan trial details to display free trial offers and terms to potential subscribers.Access Grace Period Status#
Check if subscriptions are in grace period to inform customers about payment retry status.
Merchant Integration#
For plan management operations, see the Plans API documentation. Modified at 2025-09-15 14:19:10
