Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseUse Managed Payments
Use Payment Links
Use a prebuilt checkout page
    Overview
    Quickstarts
    Customize look and feel
      Customize the appearance
      Customize text and policies
      Customize behavior
    Collect additional information
    Collect taxes
    Dynamically update checkout
    Manage your product catalog
    Subscriptions
    Manage payment methods
    Let customers pay in their local currency
    Add discounts, upsells, and optional items
    Set up future payments
    Save payment details during payment
    After the payment
    Migrate from legacy Checkout
    Migrate Checkout to use Prices
Build a custom integration with Elements
Build an in-app integration
Payment methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Payments
Payment scenarios
Handle multiple currencies
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
Beyond payments
Incorporate your company
Crypto
Agentic commerce
Financial Connections
Climate
Understand fraud
Radar fraud protection
Manage disputes
Verify identities
HomePaymentsUse a prebuilt checkout pageCustomize look and feel

Customize checkout behavior

Customize the behavior of the checkout process to increase conversion and revenue.

Filter card brands

You can specify which card brands you want to block from your customers in the Checkout Session.

To block specific card brands, you can include the brands_blocked parameter when creating a Checkout Session. Pass an array with any of the following card brand values:

  • visa
  • mastercard
  • american_express
  • discover_global_network

The discover_global_network value encompasses all of the cards that are part of the Discover Global Network, including Discover, Diners, JCB, UnionPay, and Elo.

The following code example initializes the Checkout Session with the brands_blocked parameter set to ['american_express'], which prevents customers from using American Express cards.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "line_items[0][price]"=
{{PRICE_ID}}
\ -d "line_items[0][quantity]"=1 \ -d mode=payment \ --data-urlencode return_url="https://example.com/return" \ -d "payment_method_options[card][restrictions][brands_blocked][0]"=american_express

If a customer enters an unsupported card number in Checkout, an error message notifies them that their card brand isn’t accepted.

Card brand filtering on Checkout

An error surfaces informing the customer that you don’t accept Visa (or whatever card brand you have blocked).

Additionally, Link also disables saved cards for returning users if the saved card is blocked.

Card brand filtering on Checkout with Link

If a Link user’s saved card is blocked, it is disabled.

Checkout also filters cards in Apple and Google Pay wallets, customer’s saved payment methods, and networks from co-badged cards.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access program.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc