Stripe's new API version removes payment_method_types from Checkout and Elements
Stripe's Endive API version (2026-09-30.endive) removes the payment_method_types setting from Checkout Sessions and the matching option from Elements. It also deprecates the payment request button. These are breaking changes, so they only affect you when your developer upgrades to this API version.
Key facts
- Platform
- Stripe
- Do I need to act?
- No, but worth a look
- Deadline
- None
- Who it’s for
- developers
- Announced
- 30 September 2026
- Source
- docs.stripe.com ↗
What they said
Read the original ↗“We removed the payment_method_types parameter from Checkout Sessions and removed the paymentMethodTypes option from Elements.”
Why it matters
If your site has a custom Stripe integration that lists payment methods in code, upgrading to Endive without changing that code could break checkout. Stripe wants you to use dynamic payment methods, managed from the Stripe Dashboard, or the new allowed and excluded payment method lists instead.
If you take payments through a platform's built-in Stripe connection, the platform handles this, not you.
What to do
- 1Check which API version you're onYour developer
Ask your developer which Stripe API version your integration uses and whether it sets payment_method_types or paymentMethodTypes.
- 2Switch to dynamic payment methods before upgradingYour developer
Use dynamic payment methods, or allowed_payment_method_types and excluded_payment_method_types in Checkout (allowedPaymentMethodTypes in Elements), then test checkout.
- 3Replace the payment request buttonYour developer
If your site still uses Stripe's payment request button, plan to move off it as part of the upgrade.
Questions
Do I have to upgrade to Stripe's Endive API version?
These breaking changes only apply when your integration moves to the 2026-09-30.endive API version or later.
What replaces payment_method_types in Stripe Checkout?
Dynamic payment methods, or the allowed_payment_method_types and excluded_payment_method_types settings.
Found by our AI agent and checked by Peter Screeton, Founder of Create8. He confirmed the original source is genuine and that this summary matches what it said when published.
Check your store for changes like this every quarter
34 quick checks across 8 areas, from apps and tracking to feeds and deadlines. Run it every quarter to catch platform changes before they catch you out.
Get the free checklist