O Gerador e Validador de Cartão cria números que passam no algoritmo de Luhn, para testar formulários de pagamento, e confere números digitados. O número gerado lembra o cartão de demonstração da vitrine: formato certo, nenhuma compra. Os números nascem no seu navegador e servem para testar a validação do campo e a identificação da bandeira. Para simular uma cobrança, use os cartões de teste do seu gateway, porque o ambiente de teste dele só aceita esses. Nunca use os números gerados numa compra real.
Como usar o Gerador e Validador de Cartão
Para gerar, clique na bandeira, entre Visa, Mastercard e American Express, escolha a quantidade, até 50, e copie os números para o campo de pagamento do seu ambiente de desenvolvimento. Para validar, cole um número com ou sem espaços: o Gerador e Validador de Cartão confere o cálculo de Luhn e identifica a bandeira, inclusive Elo e Hipercard. O histórico guarda os últimos 15 cartões gerados.
O que vem em cada cartão gerado
Cada item traz número, validade no formato MM/AA e código de segurança. A validade cai entre 1 e 60 meses à frente, e o código tem 3 dígitos, ou 4 no American Express. O número começa pelo prefixo da bandeira, 4 na Visa, 51 a 55 na Mastercard e 34 ou 37 na Amex, completa o tamanho com dígitos aleatórios e termina com o dígito verificador calculado por Luhn. A Visa sai com 13 ou 16 dígitos, a Mastercard com 16 e a Amex com 15.
Como ler a validação
O validador aceita de 13 a 19 dígitos e dá duas respostas separadas: se o cálculo de Luhn fecha e qual bandeira o prefixo indica. A detecção compara o prefixo com faixas públicas de BIN embutidas no código e reconhece também Elo, Hipercard e os cartões Mastercard que começam com 2. O erro comum é tratar Luhn como prova de cartão verdadeiro. O cálculo só pega erro de digitação e número inventado ao acaso; existência, saldo e bloqueio quem responde é o emissor, na autorização.
Casos de teste que valem a pena
- Um número válido de cada bandeira, para ver se o ícone certo aparece no campo.
- O mesmo número com o último dígito trocado, para ver se o formulário recusa.
- Amex com código de 4 dígitos, que muitos campos cortam em 3.
- Número colado com espaços, que o campo precisa aceitar.
Exemplo prático do cálculo
Para conferir a ideia com um número simples, use 79927398713, exemplo clássico de número que fecha em Luhn. Da direita para a esquerda, dobre os dígitos alternados: 1 vira 2, 8 vira 16 e conta como 1 + 6, 3 vira 6, 2 vira 4 e 9 vira 18, contado como 1 + 8. Os outros seis dígitos ficam como estão (3, 7, 9, 7, 9 e 7). Os alternados somam 2 + 7 + 6 + 4 + 9 = 28, os demais 42, e o total é 70, múltiplo de 10, então o dígito final fecha o cálculo. A conta explica a resposta matemática, mas não cria autorização de pagamento.
Como testar um checkout sem confundir as camadas
Primeiro teste a máscara, a aceitação de espaços, a mensagem de erro e o ícone da bandeira com números gerados aqui. Depois, no ambiente de teste do provedor, troque pelos números publicados por ele e teste respostas como aprovado, recusado e pendente. A lista de cartões do Mercado Pago, por exemplo, combina número, código e validade de teste com dados do titular para cenários específicos. Um número que passa em Luhn não reproduz esses cenários sozinho.
Erros comuns e como evitar
- Trocar o último dígito e esperar que o formulário aceite: essa troca é o caso negativo, e a recusa é o resultado certo.
- Testar somente o número: confira também se o campo aceita o código de 4 dígitos do Amex e se a máscara não corta caracteres.
- Copiar o número para produção: mantenha o teste em staging ou desenvolvimento.
Limites do Gerador e Validador de Cartão
A ferramenta testa formato e bandeira, não a cobrança: cada gateway publica seus próprios números para o ambiente de teste, como a lista de cartões de teste do Mercado Pago. O histórico guarda número, validade e código dos últimos 15 cartões gerados no navegador; limpe-o antes de gravar a tela ou compartilhar o computador.
O cálculo de Luhn responde apenas se os dígitos formam uma combinação matematicamente possível. A própria orientação do PCI Security Standards Council separa essa checagem da existência e da atividade do cartão. Por isso, não cole dados reais de cliente nesta ferramenta, mesmo quando você quer apenas conferir a formatação. Para validar uma cobrança, use o fluxo autorizado pelo seu provedor e os dados de teste dele.
Se o resultado parecer estranho, repita o teste com um número gerado, um número com o último dígito alterado e um número de teste do gateway. Compare as três respostas separadamente: formato, bandeira e autorização pertencem a etapas diferentes. Depois de confirmar o caso, limpe o histórico e registre no seu roteiro de testes qual entrada produziu cada resultado.