In certain situations, customers might choose to pause their subscription temporarily. This decision can be driven by various factors, such as:
- inability to use the product for a specific period
- temporary absence from their usual location
You have the option to pause the subscription via the API, and such paused subscriptions are identified by a distinct status - paused
.
The API provides functionalities to create, update, delete, and manage the paused
status for customer subscriptions. This allows you to set a pause period from a specific point to a designated date and make changes or cancel the pause if needed.
Manage subscription pause
The subscription pause functionality provides businesses with the ability to temporarily halt an active
subscription, allowing customers to suspend their subscription for a defined period. This functionality facilitates a seamless transition between the active status and pause status, giving customers the option to reactivate their subscription or proceed with a permanent cancellation. The subscription details include essential fields such as start_point:date
and stop_point:date
, which accurately track the duration of the pause period.
stop_point:date
can be modified. Otherwise, both the start_point:date
and stop_point:date
are available for changes.
- Go to the Subscriptions page.
- Filter subscriptions by the
active
status to find the needed one. - Click on the ➡️ icon to go to the Subscription details page.
- Click on the Create pause button and set the end and start dates.
- Click on Apply to confirm changes.
To modify the pause interval
- Go to the Subscriptions page.
- Filter subscriptions by the
paused
status to find the needed one. - Click on the ➡️ icon to go to the Subscription details page.
- In the Cancel subscription section, change the pause dates considering the following:
- If the pause is not activated, you can edit both the start and end dates of the pause.
- If the pause is already activated, you can only edit the end date of the pause.
- Click on Apply to confirm changes.
Effortlessly receive automatic notifications by subscribing to updates. notifications about status changes are sent with the
paused
type.
Subscription renewal flows
When a subscription is paused, it does not renew on its scheduled date.
- The next billing date is equal to the
expired_at
field in subscription status Webhook + days ofpause:from_date
-pause:to_date
. - In case of resuming the paused subscription manually, Solidgate recalculates the next billing date as
expired_at
field in subscription status Webhook + days of the current date -pause:from_date
.
Subscription cancellation
When a subscription is paused, only the option to
This cancellation type allows the subscriber to continue using the services until the end of the paid period while maintaining the subscription in an active status.
hard cancel
is available. The option for a
This cancellation type involves an immediate change of the subscription status to cancel.
soft cancel
is not applicable.
Resume a subscription
Only subscriptions in the paused
status can be resumed.
- Go to the Subscriptions page.
- Filter subscriptions by the
paused
status to find the needed one. - Click on the ➡️ icon to go to the Subscription details page.
- Click on Delete pause to resume the subscription.
Constraints and limitations
If the settings required for the subscription pause are incomplete or do not meet the pause conditions, an error occurs, and you receive a response with the
Understand why the payment is declined and how you can resolve it.
2.01
error code.
The error takes place when:
- pause from/to date is:
- absent in the request
- lower than the current date
- pause period is lower than 1 day
- subscription:
- does not exist
- status is not equal to
active
- is planned to be
cancelled
orpaused
-
pause:from_date
is greater than the subscriptionexpired_at
date -
pause schedule does not exist,
start_point:date
isnull