Stripe Checkout Sessions removes `payment_method_types` on creation
Introduced 2026-09-30 · score 0.97
HOW TO USE IT
If creating Checkout Sessions with `payment_method_types`, remove that parameter because it now returns HTTP 400. Use Dashboard-managed dynamic payment methods, or set `allowed_payment_method_types` to filter compatible methods; use `excluded_payment_method_types` to exclude methods.
curl https://api.stripe.com/v1/checkout/sessions \
-u <secret_key>: \
-d success_url="https://example.com/success" \
-d "line_items[0][price]"=<price_id> \
-d "line_items[0][quantity]"=2 \
-d mode=paymentWHY THIS HELPS
Update an integration that creates Checkout Sessions with `payment_method_types` to use the supported payment method configuration.
BEFORE THIS CHANGE
Pass `payment_method_types` when creating a Checkout Session; specifying an incompatible payment method returned an error.
REQUIREMENTS AND LIMITATIONS
- Version: 2026-09-30.endive
- payment_method_types: Removed from Checkout Session creation; including it returns HTTP 400.
- allowed_payment_method_types: Array of payment method types; filters to methods compatible with parameters such as currency, amount, and customer. The compatible subset appears in the response’s `payment_method_types` property.
- excluded_payment_method_types: Excludes specific payment methods from dynamic payment method results. The create API parameter details were inaccessible, so its accepted values and exact syntax were not verified.
- Prerequisite: Dynamic payment methods can be configured in the Stripe Dashboard; only enabled methods can be shown to customers.
- Passing `payment_method_types` when creating a Checkout Session now returns a `400` error.
- `allowed_payment_method_types` accepts an array of payment method types and filters the list to methods compatible with other parameters such as `currency`, `amount`, and `customer`.
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/endive/2026-09-30/remove-payment-method-types-checkout-sessions
- https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods
Check the installed version and the source before using it. Entry JSON