Adds card brand restrictions to Payment Links
What’s new
You can block specific card brands when creating or updating Payment Links using the payment_method_options[card][restrictions][brands_blocked] parameter. This feature allows you to specify which card brands customers can’t use to complete payments on your Payment Links.
The brands_blocked parameter accepts an array of card brand strings. Supported values include visa, mastercard, american_express, and discover_global_network. When a customer attempts to enter or select a card from a blocked brand, they can’t complete the payment and must choose a different payment method.
This feature is available when you create and update Payment Links, bringing Payment Links in line with the existing card brand filtering capabilities available in Checkout Sessions.
Impact
This feature is useful for businesses on interchange-plus pricing who want to avoid higher-cost card brands, or those with processing limitations that require separate handling for certain card brands.
To implement card brand restrictions, add the payment_method_options[card][restrictions][brands_blocked] parameter when you create or update a Payment Link. You can’t block all supported card brands in one Payment Link.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| payment_method_options | Added | PaymentLink PaymentLink#create PaymentLink#update |
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: 2026-05-27. dahlia
- 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.