Cancel subscription
Cancel subscriptions immediately or at period end, analyze cancellation reasons, and restore cancelled subscriptions via API or Hub
Subscription cancellations help merchants reduce risk and manage customer expectations with greater control and flexibility. Cancellations can be immediate or set for the end of the billing period and may also occur automatically based on payment process best practices.
Merchants can cancel subscriptions when needed, and automatic cancellations may happen when further billing attempts are not recommended. This can occur if a customer revokes their payment details or if payments are blocked by the fraud prevention system.
Each automatic cancellation includes a specific
By analyzing cancel codes, businesses can identify patterns and trends in cancellations. They can then understand the reasons and take steps to reduce cancellations.
- If a large number of cancellations are due to
the merchant may need to adjust their discount thresholds or pricing.invalid amounts, - If cancellations are due to issues with the
orpayment processor systems, the merchant may need to improve their security measures or work with the payment processor to address the issues.fraud prevention
Cancellation options
Solidgate subscriptions include options to cancel at the end of the billing period or cancel immediately. It offers flexibility in managing subscriptions for both businesses and customers.
- Cancel at the end of the billing period
This cancellation option allows the subscriber to continue using the services until the end of the paid period while maintaining the subscription in theactivestatus. After the current paid period is completed, the subscription status changes tocancelledautomatically. - Cancel immediately
This cancellation option involves an immediate change of the subscription status to thecancelledone. If the cancellation occurred by mistake, the subscription can be and an optional discount can be applied viarestored, coupon_idorcoupon_code.
Immediate cancellation is suitable for cases when the merchant and customer have agreed to terminate the subscription with no intention of reactivating it. This type of cancellation occurs when the force parameter has the true value in the cancel by subscription ID and cancel by customer ID methods.
It ensures the immediate cancellation of the subscription, regardless of the billing period. However, merchants can not only disable subscriptions via Hub or API. They can also use alert-based auto-cancellation for a more tailored subscription management approach. This helps implement better strategies for handling disputed transactions.
Before cancelling, consider whether temporarily pausing the subscription is also an option. When deciding whether to pause or cancel a subscription, choose the action that best fits the scenario.
| Action | When to use | Impact on billing | Impact on subscription |
|---|---|---|---|
| Pause | Customer requests a temporary break. You want to retain the customer without billing during the break. | Billing stops during the pause period. The next charge date is recalculated based on the pause duration. | Automatically resumes at the configured end date or can be resumed manually at any time. |
| Cancel at the end of the billing period | Customer confirms they want to leave but should retain access until the current billing period ends. | No further charges after the current period. Status remains active until the period ends, then changes to cancelled. | Can be restored via the restore method. |
| Cancel immediately | Use when immediate termination is needed due to fraud, dispute, or mutual agreement to stop billing. | Status changes to cancelled immediately. No further charges occur. | Can be restored via the restore method. |
You can cancel the customer’s subscription via API or SolidgateHub in several steps.
By subscription ID
Cancel subscriptionAPI v1 method allows you to cancel a subscription by providing the subscription_id and cancellation option. This option specifies whether to cancel immediately or at the end of the billing period.
Additionally, a
By customer ID
Cancel subscriptions by customer IDAPI v1 method allows merchants to cancel all subscriptions for a specific customer.
This method requires the customer_account_id and allows you to specify whether to cancel the subscription immediately or at the end of the billing period. Additionally, a cancel code can be sent to indicate the reason for cancellation.
You can check the status of a subscription or obtain particular information related to it by
To cancel a subscription
- Go to Billing.
- Find the subscription you need and click on it.
In the top-right corner, click on:
- Cancel to schedule cancellation for the end of the current billing period
- Cancel NOW to cancel the subscription immediately
- In the pop-up window, click on Cancel to confirm cancellation.
Alert-based cancellation
The system supports flexible subscription cancellation rules based on different types of alerts for both card payments and PayPal. This approach allows merchants to manage alerts according to their business needs and risk strategy, potentially reducing operational workload and chargeback rates. It also supports strategic decisions when choosing between cancellation at the billing period end and immediate one.
You can set cancellation based on the following options:
-
What to cancel
- Do not cancel anything – keeps all subscriptions active and applies to Inquiry alerts.
- Only affected subscriptions – cancels the subscriptions directly related to the alert.
- All customer subscriptions – all active subscriptions for the customer.
-
When to cancel
- At billing period end – keeps the subscription active until the current billing period ends and sends a webhook notification to the merchant.
- Immediately – applies an immediate cancellation that ends the subscription instantly and sends a webhook notification. Merchants can restore it if needed.
This feature is available by default if chargeback prevention alerts are active for your account. If you do not have such alerts, contact your account manager to activate them.
Card payments and PayPal subscriptions follow auto-cancellation rules based on specific alerts. The corresponding tables below show the available options for each alert type, based on the selected action scope and timing, with ✓ indicating the default setting.
Card payments
| Alert type | Do not cancel | Cancel only affected subscriptions | Cancel all customer subscriptions | |||
|---|---|---|---|---|---|---|
| At the end | Immediately | At the end | Immediately | |||
| Fraud alert | ✓ | ✓ | ✓ | ✓ | ||
| Prevention alert | Inquiry | ✓ | ✓ | ✓ | ✓ | ✓ |
| Init refund | ✓ | ✓ | ✓ | ✓ | ||
| Resolved | ✓ | ✓ | ✓ | ✓ | ||
| Chargeback | ✓ | ✓ | ✓ | ✓ | ||
PayPal
| Alert type | Do not cancel | Cancel only affected subscriptions | Cancel all customer subscriptions | |||
|---|---|---|---|---|---|---|
| At the end | Immediately | At the end | Immediately | |||
| External chargeback | ✓ | ✓ | ✓ | ✓ | ||
| Alert | ✓ | ✓ | ✓ | ✓ | ||
| Claim Internal chargeback | ✓ | ✓ | ✓ | ✓ | ||
| Inquiry | ✓ | ✓ | ✓ | ✓ | ✓ | |
You can apply and manage these cancellation rules by adjusting the settings in the Hub.
To set up cancellation rules
- Go to Billing > Billing settings.
- Navigate to Subscription cancellation > Cards or PayPal.
- Select the preferred option for each alert type to define what and when to cancel.
Changes are saved and applied automatically.
Stop-declines for retry logic
When you use Solidgate redemption to cancelled because the invoice cannot be paid. These decline codes include: