How Tos
Checkout
Prices & Discounts
Track & Report

Cancel & Pause Subscriptions

You can cancel or temporarily pause a user’s subscription manually in your Paddle dashboard or by using our APIs to enable your users to cancel or pause in one click.

Cancel / Pause via Dashboard

It’s often useful to be able to manually cancel or pause a customer’s subscription. To cancel or pause a user’s subscription, go to your Paddle Dashboard > Customers > Subscribers. Here you can search for the specific subsciption by the email, plan ID or subscription ID. Once you have found the subscription, click View then select Pause Subscription or Cancel Subscription under the Subscription section.

Cancel / Pause via API

Allowing users to cancel or pause their subscription is an important part of subscription lifecycle management. With Paddle you can allow your self-serve users to cancel or pause in one click using our APIs.

In order to allow your users to make subscription changes, we recommend that you first create a user/account managment area on your website or app. Here you can display the current plan the user is subscribed to and options for cancelling or pausing.

You can pause a subcription using our Update Subscription API. Here you will pass in true or false for the pause parameter along with the subscription ID and authentication parameters.

To cancel a subcription, pass the subscription ID and authentication parameters to our Cancel Subscription API.

See our API documentation for more details on the Cancel Subscription API and Update Subscription API.

Cancel Page

In addition the Dashboard and API, Paddle provides a simple subscription cancel dialog that you can redirect customers to cancel their subscription.

When a subscription is created or updated, Paddle provides a cancel URL in the Subscription Created or Subscription Updated webhook as the cancel_url POST field. The cancel URLs are unique to each customer.

The URLs change when the customer subscription is modified/updated, so make sure you subscribe to the Subscription Updated webhooks to receive the updated links.

If you are not storing the URLs at the time you receive the subscription created/updated webhook, you can access the cancel URL by calling the List Users API.

Opening Cancel Pages as an Overlay

The subscription cancel dialog can also be opened with Paddle.js, as an overlay on your site in the same format as the checkout.

Both Paddle.js buttons and Javascript methods support the cancel page. Each take an override parameter that accepts the full cancel_url sent by Paddle.

<a href="#!" class="paddle_button" data-override="https://paddle.com/example/update/url">Update Payment Information</a>