Personalizar bandeiras de cartão

Quando você usa uma página de pagamentos hospedada pela Stripe ou um formulário de pagamentos integrados, pode personalizar as bandeiras de cartão que deseja exibir para seus clientes.

Para bloquear bandeiras de cartão específicas, você pode incluir o parâmetro brands_blocked ao criar uma sessão do Checkout. Passe uma matriz com qualquer um dos seguintes valores de bandeira de cartão:

• visa
• mastercard
• american_express
• discover_global_network

O valor discover_global_network engloba todos os cartões que fazem parte da Rede Discover Global, incluindo Discover, Diners, JCB, UnionPay e Elo.

O exemplo de código a seguir inicializa a Sessão do Checkout com o parâmetro brands_blocked definido como ['american_express'], o que impede que os clientes usem cartões American Express.

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

Se um cliente inserir um número de cartão não aceito no Checkout, uma mensagem de erro notifica que a bandeira do cartão não é aceita.

Um erro aparece informando ao cliente que você não aceita Visa (ou qualquer bandeira de cartão que você bloqueou).

Além disso, o Link também desativa os cartões salvos para clientes que voltam se o cartão salvo estiver bloqueado.

Se o cartão salvo de um usuário do Link for bloqueado, ele será desativado.

O Checkout também filtra cartões em carteiras Apple e Google Pay, as formas de pagamento salvas do cliente e bandeiras de cartões com bandeiras conjuntas.