🍇 Orchard

v5.0 - 13 Aug 2026

Added

• Added resumeSubscription() so a user who cancels can change their mind during the grace period
• Added grace-period awareness end to end: cancelled subscriptions keep access until the paid-for period ends, and onGracePeriod() tells you a user is on the way out
• Added changeSubscription() to upgrade or downgrade a plan using the payment method already on file, no new checkout
• Added support for a charge currency separate from the display currency
• Added billing()->config() for reading your billing configuration
• Test suite runs through Alchemy, commands on Sprout

Changed

• cancelSubscription() cancels at the end of the billing period by default. The user paid for the current period, so access runs until it ends — pass false to revoke immediately
• Custom BillingProvider implementations must add resumeSubscription() and accept the new $atPeriodEnd argument on cancelSubscription()
• Billing now requires PHP 8.2+ and jumps from v0.3.0 to v5.0 to version alongside the rest of Leaf 5