Overview

This guide shows you how to implement Update Next Billing Date endpoint to extend the next billing date.

Use Case

Cloudify, a fictitious company offering cloud storage, wants to retain its customer by offering a pause in the subscription.

On June 23th, a customer’s Cloudify subscription renews for the monthly price.
On July 26th, the customer contacts Cloudify support to cancel because they won’t be able to use the service for a few months.
A Cloudify support agent checks the subscription in Cloudify’s internal support platform.
To retain the customer, the agent offers to pause billing for three months and resume on October 10th. The customer agrees to stay subscribed.
The agent updates the next billing date to October 10th in the internal platform (based on the Update Next Billing Date endpoint).
On October 10th, billing resumes automatically at the normal monthly price.

Implement Update Next Billing Date endpoint

You can change the next billing date for a customer's subscription to retain customers.

Before you start

Make sure that:

The subscription has the status Active.
The date to which the next billing date is updated is in the future.
If the date must be set to today, set it at least one minute in the future.

🚧
Important
Get the customer's consent for changes to subscriptions. 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.
For more information, see Best Practices: Obtain Customer Consent.

Parameters

In the call to the Update Next Billing Date API endpoint, pass the following two parameters:

Parameter	Type	Required	Example	Notes
SubscriptionId	str	Yes	S67204221	The unique identifier of the subscription.
NextBillingDate	date-time	Yes	2026-04-12T23:20:50.52Z	The next billing date of the subscription.

Diagram

flowchart LR
  classDef mainColor fill:#ffffff,color:#96C34B,stroke:#7D32C3,stroke-width:2px;

  A([<b>Jun 23</b><br/>Subscription renews + charged normal monthly price]):::mainColor
    --> BC([<b>Jul 26</b><br/>Customer contacts support to cancel<br/>Agent pauses billing for<b> 3 months</b>]):::mainColor
    --> D([<b>Oct 10</b><br/>Billing resumes automatically<br/>Charged normal monthly price]):::mainColor