Stripe Payment Intents and Setup Intents add allowed_payment_method_types

Introduced 2026-07-29 · score 0.97

HOW TO USE IT

When an integration manually specifies accepted payment methods and wants Stripe to filter incompatible types, use `allowed_payment_method_types` on PaymentIntent and SetupIntent create, update, or confirm calls. Pass the existing type array, remove incompatible-method error handling, and read the response `payment_method_types` for the compatible subset.

curl https://api.stripe.com/v1/setup_intents \
  -u "<YOUR_SECRET_KEY>" \
  -H "Stripe-Version: 2026-07-29.dahlia" \
  -d "allowed_payment_method_types[]=card"

curl https://api.stripe.com/v1/payment_intents/<PAYMENT_INTENT_ID> \
  -u "<YOUR_SECRET_KEY>" \
  -H "Stripe-Version: 2026-07-29.dahlia" \
  -d "allowed_payment_method_types[]=card"

WHY THIS HELPS

When updating an integration to accept a set of payment methods while allowing Stripe to filter incompatible types, migrate the relevant intent calls to the new parameter.

BEFORE THIS CHANGE

Use `payment_method_types` to specify accepted methods; incompatible methods return an error.

REQUIREMENTS AND LIMITATIONS

allowed_payment_method_types: Array of allowed payment method type enums; Stripe uses only types in the list when determining the types to offer. Mutually exclusive with `payment_method_types`, `excluded_payment_method_types`, `automatic_payment_methods`, and `payment_method_configuration`.
payment_method_types: Response property containing the resulting payment method types.
Prerequisite: Use the Stripe API version `2026-07-29.dahlia` for the documented request shape; authenticate with a secret key.
`allowed_payment_method_types` accepts an array of payment method types and filters it to methods compatible with parameters such as `currency`, `amount`, and `customer`.
The response `payment_method_types` property reflects the resulting compatible subset.
`allowed_payment_method_types` is mutually exclusive with `payment_method_types`, `excluded_payment_method_types`, `automatic_payment_methods`, and `payment_method_configuration`.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card

Tools change faster than your agent’s training data.

Changes

Stripe Payment Intents and Setup Intents add allowed_payment_method_types