Filter card brands

Use the Stripe Mobile Payment Element to control which card brands you accept. Card brand filtering lets you specify allowed or disallowed card brands for:

• The credit card form in the Mobile Payment Element.
• The cards buyers can use with Apple Pay.

When you configure the Mobile Payment Element, you can specify one of two options:

• Allowed: Accept only the card brands you specify.
• Disallowed: Accept all card brands except those you specify.

For either of these options, pass an array with any of the following card brand values as defined on PaymentSheet.CardBrandCategory:

• .Visa
• .Mastercard
• .Amex
• .Discover

This guide demonstrates how to use card brand filtering to only accept card payments from Visa and Mastercard branded cards.

Before you begin

1. Create a Stripe account or sign in.
2. Follow the steps in Accept in-app payments to integrate with the Mobile Payment Element.

import { useStripe } from '@stripe/stripe-react-native';

export default function CheckoutScreen() {
  const { initPaymentSheet } = useStripe();

  const initializePaymentSheet = async () => {
    const { error } = await initPaymentSheet({
      // ... other configuration options
      cardBrandAcceptance: {
        filter: PaymentSheet.CardBrandAcceptanceFilter.Allowed,
        brands: [PaymentSheet.CardBrandCategory.Visa, PaymentSheet.CardBrandCategory.Mastercard],
      },
    });
    if (error) {
      // handle error
    }
  };
}

Test your integration

Stripe provides a set of test card numbers that you can use to test your checkout flow and verify that the Mobile Payment Element accepts or blocks your desired card brands.