Downgrade Plan (Next Billing Date)

To enable customers to downgrade their plans, integrate the following flow into your system:

Step 1: Downgrade plan for customer (effective next billing date)

If the customer would like to downgrade to a cheaper plan, call the Update Subscription Item API endpoint using the ProductId that belongs to the cheaper plan. 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.

• Set GenerateMail to true so that the customer receives a confirmation email that the change was applied.

• Set TriggerImmediateRenewal to false so that an immediate renewal is not triggered.

• Set UpdateAction to Downgrade for reporting purchases.

  cURL

  curl --request POST  
  	--url <https://rest.cleverbridge.com/subscription/updatesubscriptionitem>  
  	--header 'accept: application/json'  
  	--header 'content-type: application/json'  
  	--header 'authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'  
  	--data '{  
  		"AlignmentSettings": {  
  			"AlignToCurrentInterval": false,  
  			"ExtendInterval": false,  
  			"GetCustomerPricePreviewOnly": false  
  		},  
  		"GenerateMail": true,  
  		"ProductId": 123456,  
  		"Quantity": 1,  
  		"RunningNumber": 1,  
  		"SubscriptionId": "S12345678",  
  		"TriggerImmediateRenewal": false,  
  		"UpdateAction": "Downgrade"  
  	}'
  

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

Step 2: Cleverbridge processes the downgrade (on next billing date)

Cleverbridge processes the downgrade using the payment details that we have stored in our database and sends a confirmation email to the customer.

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).