apiwatch

All changes / Stripe

Breaking rest

When you upgrade to Stripe API version 2026-09-30.endive (or an SDK major that pins it), billing_cycle_anchor on Subscription update and resume takes an object with a type field, so passing the string now or unchanged no longer works

Took effect · Stripe API 2026-09-30.endive — billing_cycle_anchor on Subscription update and resume, and Invoice create_preview subscription_details.billing_cycle_anchor

Reviewed against the vendor source on Oct 2, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

Replace now with {type: 'now'} and unchanged with {type: 'unchanged'}. When creating a preview invoice for a new subscription whose anchor is a future timestamp, subscription_details.billing_cycle_anchor needs {type: 'timestamp', timestamp: ...} instead of the bare timestamp. The SDKs that pin this version (stripe-python 16.0.0, stripe-node 23.0.0, stripe-go v87.0.0, stripe-ruby 20.0.0, stripe-java 34.0.0, stripe-dotnet 53.0.0, stripe-php 22.0.0) change the parameter's type to match.

Breaking: Calls fail after this date.

What to do

Before moving to 2026-09-30.endive or the SDK majors that pin it, send billing_cycle_anchor as {type: 'now'} or {type: 'unchanged'} on Subscription update and resume, and as {type: 'timestamp', timestamp: ...} in preview invoice subscription_details.

Strings to search for

billing_cycle_anchor="now"billing_cycle_anchor='now'billing_cycle_anchor: "now"billing_cycle_anchor: 'now'"billing_cycle_anchor": "now"'billing_cycle_anchor': 'now''billing_cycle_anchor' => 'now'billing_cycle_anchor=nowbilling_cycle_anchor="unchanged"billing_cycle_anchor='unchanged'billing_cycle_anchor: "unchanged"billing_cycle_anchor: 'unchanged'"billing_cycle_anchor": "unchanged"'billing_cycle_anchor': 'unchanged''billing_cycle_anchor' => 'unchanged'billing_cycle_anchor=unchangedBillingCycleAnchor.NOWBillingCycleAnchor.UNCHANGEDSubscriptionBillingCycleAnchor.NowSubscriptionBillingCycleAnchor.Unchanged

Counts only in files that mention stripe; repos that depend on stripe 16.x (pypi) or stripe 23.x (npm) or stripe 20.x (rubygems) or github.com/stripe/stripe-go/v87 87.x (go) or stripe/stripe-php 22.x (packagist); or repos that mention 0.endive or 1.endive or 2.endive or 3.endive or 4.endive or 5.endive or 6.endive or 7.endive or 8.endive or 9.endive or stripe==16 or stripe>=16 or stripe~=16 or stripe = "^16 or stripe = "~16 or stripe = ">=16 or stripe = "==16 or stripe = "16 or "stripe": "^23 or "stripe": "~23 or "stripe": "23 or stripe@^23 or stripe@23 or stripe-go/v87 or stripe (20. or gem 'stripe', '~> 20 or gem "stripe", "~> 20 or stripe-java:34. or Stripe.net" Version="53 or "stripe/stripe-php": "^22 or "stripe/stripe-php": "~22 or "stripe/stripe-php": "22 or stripe@npm:^23 or stripe@npm:23 (including dependency manifests).

Source

https://docs.stripe.com/changelog/endive/2026-09-30/polymorphic-billing-cycle-anchor.md