Skip to main content
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


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


Plan Downgrade Example


Billing Frequency Change


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.