Changing the subscription renewal price

Learn how to change the subscription's renewal price.

In many scenarios, it is necessary to adjust the price of subscription renewals to reflect changes in service offerings and market conditions or to provide special promotions to customers. Our API provides a straightforward mechanism for updating the renewal price of a subscription. This document outlines the steps to successfully change the subscription renewal price using a simple API request. Whether you're looking to offer a discount or respond to market dynamics, follow the instructions below to ensure you price your subscriptions according to your current strategy.

To adjust the subscription renewal price to accommodate changes in service offerings, market conditions or to offer promotions, follow these steps:

1. Initiate a POST /v1/subscriptions/{subscriptionId}/renewal-price request to change the subscription renewal price. Replace {subscriptionId} with the unique identifier of the subscription you wish to update.

2. Include the authorization token in your request headers and specify the new unit price for the subscription renewal in the request body. Ensure to replace {YOUR_API_KEY} with your actual API key and {NEW_PRICE} with the new price you are setting for the subscription renewal. Here's an example using cURL:

   Below is an example of how to make this change using cURL:

cURL

curl --location --request POST 'https://api.digitalriver.com/v1/subscriptions/{subscriptionId}/renewal-price' \
--header 'authorization: Basic ***\
...
--data-raw '{    
"renewalUnitPrice" : {NEW_PRICE}
}'

3. Upon a successful request, you will receive a 202 Accepted response indicating that the price update request has been accepted and is being processed. The new plan will go into effect on the next renewal.

Following these steps, you can easily update the renewal price for any subscription, allowing you to respond swiftly to any changes in your business or customer needs.