Capture Customer Consent for a Subscription Renewal Price Increase

Increase the customer's subscription renewal price. The following contains relevant information about this use case:



Before you increase the price of an existing subscription, keep the following in mind:

  • You must communicate with your customers and meet all legal requirements. To avoid chargebacks and customer inquiries, it is also essential that you coordinate all price increases with Client Experience.
  • In the European Economic Area (EEA), strong customer authentication (SCA) is required for recurring electronic payments when the amount changes. This means that some of your customers will have to authenticate their payment, which in turn might impact the renewal success rate.

Preconditions and Considerations

  • The subscription has the status Active.
  • The price increase takes place at the time of the next billing interval.
  • Any price changes made apply to all future billing events unless changed subsequently.
  • A second subscription product was set up in the Cleverbridge platform that is identical to the current subscription product, except for a higher price.



The second product can be omitted from public-facing product catalogs.

For more information on which API endpoint to use, see Guidelines for When to Use UpdateSubscriptionItem vs. UpdateSubscriptionItemPrice.


  1. On December 20th, a subscription is automatically renewed for $15.95 for the new monthly billing interval.
  2. On January 1st, you email the customer the option to accept or decline an increase in the monthly renewal price.
  3. On January 5th, the customer clicks a link in the email that redirects the customer to your landing page. This landing page uses the Get Subscription API endpoint to obtain and display the next billing date and other details regarding the subscription. The landing page has check boxes for the following options:
  • Accept price increase
  • Accept price increase
  1. The customer clicks the check box to accept the price increase and clicks a button to submit the response. Your landing page uses the Update Subscription Item API endpoint to replace the item in the subscription with an identical but higher-priced item.
  2. On January 20th, the Cleverbridge platform automatically bills the customer $19.95, reflecting the price increase for which the customer consented.

To achieve this particular use case, set the parameters in the Update Subscription Item Price API call to the values listed in the table.

ParameterSet to Value
SubscriptionIdThe unique identifier of the subscription.
RunningNumber1 (This subscription has only one item.)
ProductIdProduct ID for the higher priced product (not the current product being replaced).
AlignmentSettingsAlignToCurrentInterval: false

GetCustomerPricePreviewOnly: false
UpdateActionSee the note below.



The UpdateAction parameter is currently used for documentation and tracking only. The value set does not affect transaction processing.

The supported values are as follows:

  • For upgrades, set the parameter to upgrade(or 1 for JSON)
  • For downgrades, set the parameter to downgrade, (or 2 for JSON)
  • For all other changes, set the parameter to update (or 0 for JSON)


Although not utilized in this use case, the following options are also available:

  • Reduce the price of the paid subscription by applying a discount coupon that was set up in the Cleverbridge platform. This discount is applied to all future billings of the subscription.



Get the customer's consent for changes to subscriptions. For more information, see Best Practices: Obtain Customer Consent.