Update Subscription

The Update Subscription API allows a merchant to modify an existing subscription without creating a new one. Depending on the changes requested, the billing impact is determined by the merchant’s business rules and subscription configuration. The API can be used to upgrade or downgrade plans, modify subscription items, change billing frequency, or update invoice reattempt settings while preserving the existing subscription.

Subscription Update Flow

Common Use Cases

Use Case	Description
Plan Upgrade	Move a customer from a lower-tier plan to a higher-tier plan (for example, Basic to Premium).
Plan Downgrade	Move a customer to a lower-priced plan or reduce the subscription commitment.
Update Item Values	Modify the products, quantities, pricing, or other item-level details associated with the subscription.
Change Billing Frequency	Change the billing cycle, such as Monthly to Yearly or Yearly to Monthly.
Update Reattempt Configuration	Modify the retry policy for failed recurring payment attempts.
Credit on Downgrade	When moving from a yearly subscription to a monthly subscription, the remaining unused value can be credited to the customer’s account according to the merchant’s business policy.

Supported Updates

The Update Subscription API supports modifications such as:

Subscription plan
Subscription amount
Product or item details
Billing frequency
Retry (reattempt) configuration
Billing settings
Subscription metadata
Tax configuration (where applicable)

Update Lifecycle

Plan Upgrade Example

Basic Plan (₹499/month)
        │
        │ Update Subscription
        ▼
Premium Plan (₹999/month)

Plan Downgrade Example

Premium Annual Plan
        │
        │ Update Subscription
        ▼
Basic Monthly Plan

Remaining annual balance
        │
        ▼
Merchant Credit Wallet (Optional)

Billing Frequency Change

Monthly
   │
   ▼
Yearly

or

Yearly
   │
   ▼
Monthly

Notes

The subscription remains the same; only its configuration is updated.
Future invoices are generated using the updated subscription configuration.
Billing adjustments, prorations, or credits depend on the merchant’s business rules.
Downgrades may result in customer credits based on the remaining subscription value.
Updating the billing frequency affects all future billing cycles.
Changes to the retry configuration apply only to future payment failures.

Geting Started

Manage Subscription

Subs Invoices/ Pay Lifecycle

Subs Checkout

Test Your Subscription

Subscription Update Flow

Common Use Cases

Supported Updates

Update Lifecycle

Plan Upgrade Example

Plan Downgrade Example

Billing Frequency Change

Notes

​Subscription Update Flow

​Common Use Cases

​Supported Updates

​Update Lifecycle

​Plan Upgrade Example

​Plan Downgrade Example

​Billing Frequency Change

​Notes

Subscription Update Flow

Common Use Cases

Supported Updates

Update Lifecycle

Plan Upgrade Example

Plan Downgrade Example

Billing Frequency Change

Notes