# Manage subscriptions

Solidgate API for <a href="https://docs.solidgate.com/billing/subscriptions/subscriptions-1.0/subscription-overview/" target="_blank">subscriptions</a> empowers merchants in efficiently and securely managing subscriptions for a positive customer experience and business growth.

Merchants can <a href="https://docs.solidgate.com/billing/subscriptions/subscriptions-1.0/manage-subscription/" target="_blank">easily handle</a> their subscriptions using the available methods such as switching subscription products, pausing and resuming services, cancelling subscriptions, and providing customers with the option to update payment information.

## Update subscription

 - [POST /subscription/update](https://api-docs.solidgate.com/api/manage-subscriptions/update-subscription.md): By using this method, merchants can update an active subscription by modifying the trial period, applying a discount, or changing the product. It allows multiple changes in a single request for efficient subscription management and customer retention.

## Switch product

 - [POST /subscription/switch-subscription-product](https://api-docs.solidgate.com/api/manage-subscriptions/switch-subscription-product.md): By using this method, merchants can update the product in the active subscription with a new one. After the switch request is made, a callback confirms the update and includes the new subscription product. The updated settings take effect on the next billing date.


  The switch is subject to conditions related to currency and location compatibility between the current and new products.

## Update subscription token

 - [POST /subscription/update-token](https://api-docs.solidgate.com/api/manage-subscriptions/update-subscription-token.md): This method provides a mechanism for merchants to update the payment token when the customer's preferred payment method changes.

## Create subscription pause

 - [POST /subscriptions/{subscription_id}/pause-schedule](https://api-docs.solidgate.com/api/manage-subscriptions/create-subscription-pause.md): By using this method, merchants can schedule a subscription pause, setting the specific start and end dates for the pause period.

## Update subscription pause

 - [PATCH /subscriptions/{subscription_id}/pause-schedule](https://api-docs.solidgate.com/api/manage-subscriptions/update-subscription-pause.md): By using this method, merchants can modify the existing pause schedule, including the possibility of adjusting the start and end dates of the pause period.


  Note that if the subscription pause is active, only its end date can be updated, while an inactive pause allows for updates to both start and end dates.

## Remove subscription pause

 - [DELETE /subscriptions/{subscription_id}/pause-schedule](https://api-docs.solidgate.com/api/manage-subscriptions/delete-subscription-pause.md): This method provides a way to delete the scheduled pause, reverting the subscription to its previous active state or as specified.

## Cancel subscription

 - [POST /subscription/cancel](https://api-docs.solidgate.com/api/manage-subscriptions/cancel-subscription.md): By using this method, merchants can cancel the specific subscription by its subscription identifier.

## Cancel subscriptions by customer

 - [POST /subscription/cancel-by-customer](https://api-docs.solidgate.com/api/manage-subscriptions/cancel-subscriptions-by-customer.md): By using this method, the merchant can cancel all subscriptions for the specific customer.

## Restore subscription

 - [POST /subscription/restore](https://api-docs.solidgate.com/api/manage-subscriptions/restore-subscription.md): By using this method, merchants can restore the specific subscription of their customer in case it was cancelled.

## Subscription payment updates

 - [POST Billing](https://api-docs.solidgate.com/api/manage-subscriptions/webhook-subscription-status.md): Webhooks for subscription status provide real-time notifications about changes in subscription status. 

The webhook structure is similar to the subscription status method but additionally includes the callback_type parameter in the response object.

There are two versions of subscription events: legacy and extended.
The extended version offers an enhanced webhook event set with more detail and context, giving merchants deeper insights into subscription stages for better management and analysis.
The legacy version remains supported until the end of June 2026.


  Duplicate webhook events can occur. Implement idempotency on your end to avoid processing the same event twice.


Parameters for each callback type can vary based on factors such as product type, payment method, trial availability, or other specific conditions.