Renew a Data-Limited Subscription Early at Full Price

As a company providing data-limited subscriptions, you may want to reset a customer's billing interval when renewing their data package. If a customer's subscription has reached its data limit and they wish to immediately renew it at full price to keep using your service, follow the scenario outlined below to renew their subscription:

Step 1: Process renewal for customer

Call the Renew Subscription API endpoint and do the following:

  • Set ResetBillingInterval to true
  • Include the customer's SubscriptionId

Cleverbridge immediately processes the renewal using the payment details that we have stored in our database. We immediately bill the customer the full price for the next billing interval. The next billing interval also starts immediately, and the next billing date changes.

curl --request POST \
  --url https://rest.cleverbridge.com/subscription/renewsubscription \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  --data '{
    "SubscriptionId": "S12345678",
    "ResetBillingInterval": true
  }'

Step 2: Confirm to customer that payment was processed

After receiving the response, forward the customer to the confirmation page in the ContinueUrl field. If the transaction is not successful, the page linked in the ContinueUrl field will inform the customer about the next steps, such as updating the payment details in case of a failed payment.

{
  "ContinueUrl":"http://www.cleverbridge.com/2/p/123546-sf78g97sd897g8df"
  "NextBillingDate":"2018-05-15T23:20:50.52+00:00"
  "TransactionStatus":"Success"
  "ResultMessage":"OK"
}

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