Managing subscriptions often means responding to real-life customer behavior, including special offers or adjustments to pricing plans. The Solidgate subscription update allows you to handle multiple subscription modifications through a single request. It ensures quick responses to customer needs without complex sequences of actions. This flexibility aims to reduce churn while supporting retention and upselling strategies.
You can use the following subscription management options on their own or combine them to match the specific business case:
-
Manage trial
Adjust the trial period to support customer decisions. You can:- extend the trial to a future date to give the customer more time
- end the trial immediately to convert the customer to a paid plan, optionally with a discount to encourage early commitment
-
Offer discount
Use discounts applied starting from the next billing period to keep customers engaged in your offers. You can:- apply coupon ID to an active subscription
- offer your customer a coupon code
-
Upgrade and downgrade subscription
Change customer's subscription plans and recalculate the invoice to charge or refund the price difference. You can:- change product and offer a discount to meet customer's needs
- skip trial and change product to provide a more tailored offering
id
and at least one field with a preferred value to apply the needed change. You can update the trial period, apply a discount using a coupon_id
or coupon_code
, or switch to a new product by passing the new product_id
. Changes can be combined in one request if needed.
Handle subscription update errors
When an update request cannot be processed, you receive an error response that helps you quickly locate and fix the reason for the error.
Common error scenarios appear when:
- Request excludes required fields or includes incorrectly formatted data. For example, the
trial_ended_at
field must not be empty if you include the trial information. - Request format is correct but does not match the current state of the subscription. For example, if the subscription is no longer in a trial period, trying to skip or extend the trial results in an error.
- Request includes an unsupported value. For example, an unsupported value is passed for the
trial_ended_at
field, only immediate or specific_date values are allowed.