apiwatch

All changes / Stripe

Breaking sdk

In Stripe.js Endive, Elements with Checkout Sessions integrations that set a Payment Element billing field to never must supply any required billing data for it another way, or checkout.confirm() throws an integration error

Took effect · Stripe.js Endive — Elements with Checkout Sessions: Payment Element fields.billingDetails 'never' and checkout.confirm()

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

What changes

Previously checkout.confirm() could succeed even when a required billing field set to never wasn't provided through another source. Optional fields such as address.line2 are exempt. Previous Stripe.js major versions keep the earlier behavior.

Breaking: Calls fail after this date.

What to do

Before moving to Stripe.js Endive, supply every required billing field you set to never: call updateBillingAddress, updateEmail or updatePhoneNumber, pass billingAddress, email or phoneNumber to checkout.confirm(), or use the Billing Address Element. With automatic tax, provide the address through the Address Element or updateBillingAddress rather than checkout.confirm(). Or set only the fields you collect yourself to never and leave the rest auto.

Strings to search for

billingDetails: 'never'billingDetails: "never"name: 'never'name: "never"email: 'never'email: "never"phone: 'never'phone: "never"address: 'never'address: "never"country: 'never'country: "never"postalCode: 'never'postalCode: "never"state: 'never'state: "never"city: 'never'city: "never"line1: 'never'line1: "never"

Counts only in files that mention billingdetails + initcheckout or billingdetails + usecheckout or billingdetails + checkoutprovider or billingdetails + checkoutelementsprovider or billingdetails + createpaymentelement or billingdetails + react-stripe-js/checkout; repos that depend on @stripe/stripe-js 10.x (npm) or @stripe/react-stripe-js 7.x (npm); or repos that mention js.stripe.com/endive or "@stripe/stripe-js": "^10 or "@stripe/stripe-js": "~10 or "@stripe/stripe-js": "10 or @stripe/stripe-js@^10 or @stripe/stripe-js@10 or @stripe/stripe-js@npm:^10 or @stripe/stripe-js@npm:10 or "@stripe/react-stripe-js": "^7 or "@stripe/react-stripe-js": "~7 or "@stripe/react-stripe-js": "7 or @stripe/react-stripe-js@^7 or @stripe/react-stripe-js@7 or @stripe/react-stripe-js@npm:^7 or @stripe/react-stripe-js@npm:7 (including dependency manifests).

Source

https://docs.stripe.com/changelog/endive/2026-09-30/strict-billing-details-validation.md