Menu

Números de cartão de teste por bandeira: como escolher

Números de cartão de teste por bandeira seguem faixas de prefixo, comprimentos e códigos de segurança diferentes. Veja como escolher e montar a sua matriz.

Publicado em

  • bandeiras
  • cartão de teste
  • integração

Escolher números de cartão de teste por bandeira é o passo que separa uma bateria de testes realista de uma que só prova que o caminho feliz funciona. Cada bandeira tem faixa de prefixo, comprimento e formato de código de segurança próprios, e é exatamente nessas diferenças que moram os defeitos de checkout que chegam à produção.

Como o prefixo revela a bandeira

Os primeiros dígitos do número formam o identificador do emissor, e as faixas são atribuídas por bandeira. Na prática, isso permite que um formulário reconheça a bandeira assim que o cliente termina de digitar o começo do número, antes de qualquer contato com a rede de pagamentos.

Esse reconhecimento melhora a experiência e cria obrigações: se a interface mostra o nome da bandeira, o comprimento aceito e o formato do código de segurança precisam acompanhar. Uma tela que anuncia uma bandeira e exige o número de outra é um erro de coerência fácil de introduzir e difícil de perceber sem testes por bandeira.

Faixas públicas de cada bandeira

As faixas a seguir são informação pública, publicada pelas próprias bandeiras e por organismos do setor:

Bandeira Faixa de prefixo Comprimento usual Código de segurança
Visa começa com 4 13, 16 ou 19 dígitos 3 dígitos no verso
Mastercard 51 a 55 e 2221 a 2720 16 dígitos 3 dígitos no verso
American Express 34 e 37 15 dígitos 4 dígitos na frente
Discover 6011, 65, 644 a 649 e 622126 a 622925 16 dígitos 3 dígitos no verso
JCB 3528 a 3589 16 dígitos 3 dígitos no verso
Diners Club 300 a 305, 36 e 38 a 39 14 dígitos 3 dígitos no verso
UnionPay começa com 62 16 a 19 dígitos 3 dígitos no verso
Maestro 50 e 56 a 69 12 a 19 dígitos 3 dígitos no verso

Os valores da coluna de prefixo são intervalos curtos, usados apenas para escolher o começo de um número plausível. Nenhum dado desta tabela diz respeito a uma conta específica, e a presença de um prefixo não indica que a loja aceita ou deixa de aceitar aquela bandeira.

Comprimento e código mudam com a bandeira

Dois detalhes dessa tabela merecem destaque, porque quebram validadores com frequência:

  • Um comprimento fixo de dezesseis dígitos recusa cartões legítimos de quinze e de catorze dígitos. A validação correta usa a faixa de comprimentos permitida para cada bandeira.
  • O código de segurança nem sempre tem três dígitos nem fica no verso. Uma tela que sempre pede três dígitos no verso está errada para pelo menos uma bandeira conhecida, que usa quatro dígitos na frente — como detalha a página sobre o que é CVV.

Há também bandeiras que compartilham prefixos com outras ou que operam faixas muito extensas, o que torna a detecção uma aproximação, e não uma certeza.

Quantas bandeiras preciso cobrir?

Depende do que a loja aceita de verdade. Uma boa heurística é começar pelo que aparece nos dados reais: quais bandeiras respondem pela maior parte das tentativas de pagamento, quais têm histórico de recusa e quais foram adicionadas recentemente.

A partir daí, vale garantir pelo menos um caso por família de formato, e não necessariamente por marca:

  • Uma bandeira de dezesseis dígitos com código de três dígitos.
  • Uma bandeira com comprimento diferente, para exercitar a validação variável.
  • Uma bandeira com código de quatro dígitos, para exercitar o campo e o teclado.
  • Uma bandeira com faixa extensa de comprimentos, para verificar o limite superior aceito.

Esse conjunto pequeno já cobre a maioria dos defeitos reais e é fácil de manter atualizado.

Um número aceito pela validação é aceito pela loja?

Não. A validação local confirma apenas que o número tem formato coerente. Aceitação é outra coisa: depende de a loja habilitar aquela bandeira, de o adquirente suportar a faixa e, por fim, da autorização do banco emissor.

Um teste útil separa os dois casos. Primeiro, verifique que a sua validação aceita o número. Depois, verifique que o fluxo trata corretamente a recusa de uma bandeira não habilitada, com uma mensagem que faça sentido para o cliente.

Montando o conjunto no gerador

Manter números de oito bandeiras à mão, com comprimentos e códigos coerentes, é trabalhoso e envelhece rápido. No gerador de cartão virtual desta página você escolhe a bandeira, define a quantidade e recebe número, validade e código de segurança já compatíveis entre si — inclusive o código de quatro dígitos na frente, quando a bandeira exigir.

Os resultados são estruturalmente válidos, mas nunca foram emitidos por nenhuma instituição e não podem ser usados em uma cobrança real: são dados para preencher formulários em ambiente de teste.

Para quem desenvolve: a matriz de bandeiras

Para transformar a tabela acima em uma bateria organizada:

  • Fixe a amostra de cada bandeira em um arquivo versionado, e não em números escolhidos na hora.
  • Nomeie cada caso de teste pela bandeira e pelo comportamento esperado, para que a falha aponte direto para a regra errada.
  • Cubra o limite inferior e o superior de comprimento de cada faixa que você aceita.
  • Inclua um caso de prefixo não reconhecido e confirme a mensagem exibida.
  • Verifique se o mesmo número se comporta igual no cliente e no servidor, como discute o texto sobre validar número de cartão.
  • Reavalie a lista quando uma faixa nova for anunciada por alguma bandeira.

Próximos passos

Se você já tem a matriz, o próximo passo é testar os campos restantes do checkout: comece pelo formato da data de validade e siga para o checklist de teste de formulário de pagamento. Se ainda faltam números para montar a amostra, gere os conjuntos no gerador de cartão virtual.

Continue lendo

Artigos sobre Gerador de número de cartão de crédito falso