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:

🚧

Important

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.

📘

Note

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

• The billing interval is the same for the current and new subscription product.
• Use of the CustomerPrice parameter in the API response is optional. Before doing so, see Understand Customer Price.
• Use the AlignmentSettings parameter for the subscription in the API response is required. Before doing so, see Get Started with Subscription API > Alignment Settings.

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

Description

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

4. 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.
5. 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.

📘

Note

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)

Options

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.

🚧

Important

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

Illustration