Update subscription

[ { "title":"Testing", "link":"https://docs.solidgate.com/payments/testing/", "text":"Simulate payments to test your integration before launching in production.", "imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-customizable.svg" } , { "title":"Create your payment form", "link":"https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form/", "text":"Understand how to integrate the payment form into your product.", "imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-payments.svg" } , { "title":"Billing", "link":"https://docs.solidgate.com/billing/", "text":"Smart billing solutions designed for diverse business models.", "imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-global.svg" } ]

Get in touch
Sign in
Update subscription
Adjust and personalize offers with one subscription update request

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
Update subscription API method requires the merchant's unique identification and signature in the header parameters. The request body must include the current subscription 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
anchor

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:

  1. 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.
  2. 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.
  3. 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.
Looking for help? Contact us
Stay informed with Changelog