Paddle Billing
Search

Pause trialing subscriptions

Pause subscriptions in trial at the end of the trial period. They move out of trial when they're resumed.

What's new?

You can now pause trialing subscriptions.

There are no changes to endpoints or fields in the API as a result of this change — it's an update to the way the Paddle platform handles trialing subscriptions.

How it works

Previously, you couldn't pause a subscription where its status was paused. We updated the Paddle platform so now you can pause trialing subscriptions at the end of the billing period. The end of the billing period in this case is the end of the trial period.

You might let customers pause a trialing subscription when they've evaluated your app and entered data, but aren't yet ready to transition to paying.

Trialing subscriptions can only be paused at the end of the billing period, which is the default option when making a request using the pause subscription operation. You can't pause them immediately.

Summary of changes

Changes to error messages

This change is an update to the way the Paddle platform handles trialing subscriptions. Error messages are the same, but may be returned in different circumstances:

subscription_update_when_trialingNo longer returned when pausing subscriptions in trial. It's still returned when making other unsupported changes to trialing subscriptions.

Next steps

This change is available in version 1 of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

Check out our work with trials guide to get started.

Learn more