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 consider combining them to match the specific business case:
- Manage trial
Adjust the trial period to support customer decision-making and improve their experience.
For example, typical use cases include:
- extend the trial to give the customer more time to explore the product
- end the trial to convert the customer, optionally with a discount
- Offer discount
Provide discounts applied starting from the next billing period to retain customers and encourage continued subscriptions.
For example, you might consider such options:
- apply a coupon ID to an active subscription
- provide a coupon code the customer can redeem
- Upgrade and downgrade subscription
Modify customer subscription plans and adjust the invoice to charge or refund the price difference.
For example, possible actions to combine:
- change the product and apply a discount to meet customer needs
- skip the trial and change the product to provide a more tailored offer
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.