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