Renew Subscription Early with Discount

Voluntary churn occurs if a customer actively chooses to cancel their subscription. To prevent voluntary churn, you can implement a number of prevention measures, including offering customers a discount if they renew early. To renew a customer's subscription early with a discount, integrate the following flow into your system:

Step 1: Set up a promotion in Commerce Assistant

To do so, click Marketing > Add a Promotion in the main menu.

Create and Save the promotion, paying particular attention to the following:

In the Discount section, make the discount a one-time offer by clicking the Apply to one subscription billing interval only checkbox.

In the Coupon section, Generate one or more coupon codes to be used in the campaign.

Step 2: Add coupon code to existing subscription and trigger renewal

If a customer would like to renew early with a discount, call the Update Next Billing Date API endpoint to reset the next billing date to the current date and time. In the API call, do the following:

  • Set all parameters in the AlignmentSettings argument to false so that the change is applied to the next billing interval.
  • Add the promotional code that you created in Step 1 to CouponCode.
  • Set GenerateMail to true so that the customer receives a confirmation email that the transaction was applied.
  • Set TriggerImmediateRenewal to true so that an immediate renewal is triggered using the payment details that Cleverbridge has stored in our database. The billing interval is also updated.
  • Set UpdateAction to Updatefor reporting purchases.
curl --request POST \
  --url \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  --data '{
      "ExtendInterval": false,
      "GetCustomerPricePreviewOnly": false
    "CouponCode": "YMR-DZZ-Z5J",
    "GenerateMail": true,
    "ProductId": 123456,
    "Quantity": 1,
    "RunningNumber": 1,
    "TriggerImmediateRenewal": true,
    "UpdateAction": "Update"

For more information about the AlignmentSettings argument, see Alignment Settings.

Step 3: Cleverbridge sends you a PaidOrderNotification

For more information, see Step 3: Cleverbridge sends you a PaidOrderNotification in Combine Upgrade with Early Renewal (Basic to Premium).