Customize card brands

When you use a Stripe-hosted payment page or embedded payment form, you can customize the card brands you want to display to your customers.

To block specific card brands, include the brands_blocked parameter when you create 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.

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 success_url="https://example.com/success" \
  -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.

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 customers if the saved card is blocked.

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.