There are various reasons vendors and customers may want to pause a recurring subscription rather than fully cancel.
Below are instructions to allow vendors to manually pause subscriptions as well as enable billing portal self-serve options to pause billing as well.
Vendor: Manual Pause Options
Via product settings vendors can set up billing portal self-service options to allow customers to pause their subscription by themselves via their billing portal.
You’ll need to go to ‘Campaigns’ on the left sidebar of your dashboard. Here, you’ll see your campaigns listed. Choose the PRODUCT that you want to enable the billing portal subscription pause option for.
Under Pricing settings(section 1), Enable “Available On Billing Portal“, then Enable “Pause Subscription“.
You can now set how long you want to allow subscription to pause for, and also set a charge fee(optional) to charge the customer when pausing.
Length: # related to Length Type
Length Type: Days, Weeks, Months, Years, or Forever.
Length will be related to the maximum amount of time the customer’s subscription can remain paused.
Charge Fee(Optional): Used to charge the customer for pausing subscription.
Amount: The amount you want to charge
Recurring Frequency: # Related to Length Type.
Recurring Frequency Type: Days, Weeks, Months, Years
The final step will be to go to the billing portal settings section and enable the “Pause subscription” option either in the PK default portal option or your portal embed options.
Once you are happy with your settings, go to the top of the page and save your product settings.
After saving, customer will be able to pause their subscription via the Billing Portal.
Both you or the customer are able to un-pause the subscription at anytime via the customer billing portal or the subscriptions dashboard in your vendor account.
Customer: Self-Serve Options
Vendors also have the ability to manually with or without the option being enabled in the customer billing portal.
Go to the Subscriptions dashboard and locate the customer you want to pause.
Once the customer subscription is located, click the pause button.
Unpause Date: Set a specific date to un-pause the customer subscription and continue billing. If you want to pause the subscription indefinitely, leave the date field blank.
Charge A Fee(optional): If you want to charge customers for pausing you can enable and set the following options before pausing.
Amount: The price you want the customer to pay
Every: # and recurring frequency you want to charge them. Ex: 1 Month.
You can now click to finish pausing and save.
Paused Subscriptions will show in your Subscriptions dashboard with a filter status of “Paused”
– Result #1: If the next billing date for the subscription has not passed, the customer will be charged once the next billing date happens. This is called “Inside Next Billing Period Resume“(See below)
– Result #2: If the next billing date for the subscription has already passed, the customer will be charged immediately after unpausing. This is called “Outside Next Billing Period Resume“(See below)
Inside Next Billing Period Resume:
If a subscription is paused and resumed within the current billing cycle of the subscription, the customer will be charged on their upcoming billing date after unpausing.
Example: The subscription rebills on the 1st of every month and the subscription is paused on the 15th and resumed on the 25th, this is considered as an inside next billing period resume. The customer will be charged on their normal billing date.
Outside Next Billing Period Resume:
When a paused subscription resumes after the set “next billing date”, it is considered as outside the next billing period Resume. In this case, the customer will be charged as soon as they unpause. After the charge, the customer’s next billing date will be reset in line with their normal billing frequency.
Example: The Subscription rebills on the 1st of every month. If the subscription is paused on the 15th and resumed on the 28th of the next month, this is considered as outside the next billing period Resume and the customer is charged immediately after unpausing, then next billing date will be set.
Subscription paused and unpaused events will also be an available event with our IPN.
There are currently no API calls for pausing and unpausing subscriptions. If your development team needs API calls for pausing/unpausing, please submit a feature request here.