We are now showing plan phases in subscription timelines, allowing you to see when the given phase of a plan starts and ends.

When creating a new subscription or scheduling a plan change, you may now select a plan version to subscribe to. Previously, new subscriptions could only and plan changes could only target the default version.

This functionality is also available in the API, via the plan_version_number field in the create subscription endpoint, and the schedule plan change endpoint. If the field is null or absent, the default version will be used.

Orb's API now supports adding, removing, and replacing prices when creating a new subscription, or changing the plan for an existing subscription (See: Subscription Price Overrides). This is useful when a new customer has negotiated one or more different prices for a specific plan than the plan's default prices.

For information on how to use this feature, see the API specification:

• Create subscription API
• Schedule plan change API

You can now set a customer’s tax exemption status - tax exempt or not tax exempt directly from the Create Customer or the Update Customer API endpoints. This feature enables smoother integrations and more automated workflows for managing tax compliance. You could use this to: exclude tax collection for customers in specific countries, mark tax-exempt organizations like nonprofits or government entities as tax-exempt in Orb upon creation, or manage tax externally for a specific subset of customers.

More information about Orb's supported tax providers can be found here.

There is a new view for a customer's subscription. The page displays metadata, pricing configuration, and activity history specific to a subscription.

Browse to the desired subscription on the customer page, open the overflow menu and click on 'View Details' to see the subscription details.

Orb now allows you to anchor your billing cycles to a custom date. Previously, you were able to specify the day of the month on which billing cycles were anchored. Now, you're able to specify a full date. 

For example, a quarterly subscription anchored on March 16, 2024 with a start date of October 10, 2023 and an end date of March 16, 2024 would have the following billing periods: October 10, 2023 - December 16, 2023, December 16, 2023 - March 16, 2024.

Orb now supports specifying a custom billing cadence or one-time service period. Previously, prices could only recur monthly, quarterly, semi-annually, or annually. Now you're able to specify a custom duration in days or months. You can also now specify a custom service period duration for one-time prices, which determines the duration of the line item.

Orb now allows adding and removing prices during subscription creation and plan change. Previously, plan overrides only allowed prices to be modified. This allows the creation of a wide variety of custom plans using a small number of template plans, without having to construct the new plans from scratch. It also makes it easy to create add-ons to existing plans and subscriptions.

See the docs here: Subscription price overrides

Orb has now released the ability to schedule start of term migrations! This option takes advantage of the fact that Orb knows the billing period of each price across all your individual subscriptions and will schedule the migration for each subscription at the start of the subscription's term.

This allows you to make pricing changes in the middle of a billing period without disrupting your normal invoicing cadence, allowing you to decouple feature rollouts and pricing changes in Orb. For example, if you bill your customers monthly and want to roll out a new feature mid-month , you can simply turn on the feature for your customers and start reporting usage, and then schedule a beginning of term migration to a new plan version, and Orb will ensure that each customer's end of month invoice includes all of the usage for the whole month.

Orb now allows adding and editing individual adjustments (discounts, minimums, and maximums) on a subscription. You can programmatically model adjustments to your pricing while maintaining total control over billing and invoicing; this can be used to allow customers to redeem coupons on a subscription or to allow your support team to easily give discounts as needed. Adjustments can be backdated into the past or scheduled for the future, and Orb will always correct your customer's invoices to ensure correct billing. Adjustment intervals can be modified using our price intervals API — see the docs here.