Adds support for blocking specific card brands in Checkout Sessions
What’s new
Adds the payment_method_options.card.restrictions.brands_blocked parameter to the Create a Checkout Session method. You can pass in an array of card brands that you don’t want the Checkout Session to allow.
Impact
For details about how to filter card brands in Checkout, see the guide on customizing Checkout behavior.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| restrictions | Added | Checkout. Session#create. payment_method_options. card Checkout. Session. payment_method_options. card |
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-02-24. acacia
- 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.