Move the next subscription charge later
Moves an active or trialing Stripe subscription’s next charge strictly later, up to 90 days from now. The intervening days are free, with no charge or proration. Scheduled cancellation and paused collection are refused. Dates use RFC 3339 UTC timestamps. Reason text is stored encrypted.
/subscriptions/{subscription}/next_charge_dateMoves an active or trialing Stripe subscription’s next charge strictly later, up to 90 days from now. The intervening days are free, with no charge or proration. Scheduled cancellation and paused collection are refused. Dates use RFC 3339 UTC timestamps. Reason text is stored encrypted.
In: header
Path Parameters
Opaque subscription ID.
^sbs_[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}$(?![\s\S])Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/subscriptions/string/next_charge_date" \ -H "Content-Type: application/json" \ -d '{ "next_charge_date": "2019-08-24T14:15:22Z" }'{ "dry_run": true, "plan": { "subscription": "string", "next_charge_date": "2019-08-24T14:15:22Z", "proration_behavior": "none" }}Cancel a line that expands to one entire subscription POST
Previous Page
Change a live subscription item quantity POST
For active, trialing or past_due subscriptions. Increases and decreases apply immediately using the product proration setting, preserving the billing date. Flat per-unit licensed seats and plain per-unit metered components support renewal notices. Tiered, package, decimal and special-term components, and other unsupported resulting shapes, return notice_unsupported_shape. An unchanged quantity returns 409 quantity_unchanged without an operation. Bill-now changes refuse an unsuccessful immediate payment. Requires a merchant person or key; agent approvals and customer sessions are not supported.