Adds excluded payment method types to the Payment Intents API
What’s new
This change adds a new excluded_payment_method_types field that you can set when creating a PaymentIntent.
Impact
You can use the new field to explicitly exclude payment methods from displaying on a per-transaction basis. The payment_method_types returned on the PaymentIntent doesn’t include these excluded payment methods. If you use Checkout or Elements, the excluded payment methods doesn’t display to users.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| excluded_payment_method_types | Added | PaymentIntent PaymentIntent#create |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-08-27. basil
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.