Gerador de Cartão de Crédito para testes

Como funciona a validação de cartão?

Números de cartão de crédito são validados pelo algoritmo de Luhn (mod-10), um checksum que detecta erros de digitação. O primeiro dígito identifica a bandeira: 4 para Visa, 5 para Mastercard. Cartões Elo usam prefixos específicos como 636368 e 438935. O FakeForge gera números que passam na validação Luhn para as cinco bandeiras.

Bandeiras, prefixos e tamanho do número

Todos os números terminam em dígito verificador Luhn. O Amex é o único com 15 dígitos, agrupados em 4-6-5, e CVV de 4 dígitos.

A Mastercard também emite a faixa 2221 a 2720, que este gerador não usa. Os prefixos 4 e 51 a 55 cobrem a grande maioria dos formulários.

Para que usar cartões fictícios?

Testar fluxos de checkout em e-commerce, validar integração com gateways como Mercado Pago, PagSeguro, Stripe e Cielo. Verificar se a máscara de input aceita diferentes bandeiras. Popular bancos de dados de teste com dados de pagamento realistas sem usar cartões reais.

Esses cartões funcionam para compras?

Não. Os números passam apenas na validação matemática (Luhn). Eles não estão vinculados a nenhuma conta bancária, não têm limite de crédito e serão recusados por qualquer gateway de pagamento em ambiente de produção. São exclusivamente para testes.

Cartão de crédito vs cartão de débito

O número de cartão de crédito e cartão de débito segue exatamente o mesmo padrão ISO/IEC 7812: 16 dígitos, prefixo BIN da bandeira (4 para Visa, 51-55 para Mastercard, etc.) e dígito verificador Luhn no final. Visualmente e no algoritmo, são idênticos.

A diferença está no tipo de conta vinculada ao número (corrente/poupança para débito, conta de crédito para crédito) e no fluxo de autorização (débito exige saldo em tempo real, crédito tem limite pré-aprovado). Para teste de formulário, validação Luhn e mock de checkout, o gerador de cartão funciona indistintamente como gerador de cartão de crédito ou gerador de número de cartão de débito.

Se você precisa diferenciar débito vs crédito no fluxo de teste, use o campo de bandeira/tipo do seu formulário. Para testes ponta-a-ponta no gateway, use os cartões de teste oficiais do PSP (Stripe, Mercado Pago, Pagar.me, Adyen, Cielo) que já vêm marcados como débito ou crédito no sandbox.

Números de teste por gateway

Para testar ponta a ponta no sandbox, use os números que o próprio gateway publica. Um número gerado aqui passa no Luhn, mas o gateway só simula aprovação ou recusa para os números da documentação dele.

4242 4242 4242 4242 (Stripe, Visa)
5555 5555 5555 4444 (Stripe, Mastercard)
4000 0000 0000 0002 (Stripe, recusa genérica)

A Cielo também publica cartões de sandbox, em que o último dígito define o retorno simulado. Confira sempre a documentação atual de cada gateway, porque esses números mudam. Para entender quando usar cartão gerado e quando usar cartão oficial, veja Fake vs Stripe test.

Bandeira, BIN e uso (ISO/IEC 7812)

A norma ISO/IEC 7812 define que os primeiros 6 a 8 dígitos formam o IIN (BIN), que identifica o emissor e a bandeira. O primeiro dígito é o MII (Major Industry Identifier): 3 para viagem e entretenimento, 4 e 5 para bancos, 6 para bancos e varejo.

Por que Luhn?

Hans Peter Luhn (IBM) criou o algoritmo em 1954 para detectar erros de digitação. Ele pega todo erro de um único dígito e quase todas as trocas de dígitos vizinhos, sem consultar nenhuma base. Não é criptografia nem prova de que a conta existe.

1. Separe o último dígito (o verificador). Nos demais, comece pela direita.
2. Dobre um dígito sim, um não, a partir do primeiro da direita. Se o dobro passar de 9, subtraia 9.
3. Some todos os dígitos resultantes.
4. O verificador é (10 - soma mod 10) mod 10. O número é válido quando a soma total, com o verificador, é múltipla de 10.

Exemplo com 424242424242424: os 8 dígitos 4 dobrados viram 8 cada (soma 64), os 7 dígitos 2 somam 14, total 78. O verificador é (10 - 8) mod 10 = 2, o que dá 4242 4242 4242 4242.

def luhn_valido(numero: str) -> bool:
    digitos = [int(c) for c in numero if c.isdigit()]
    soma = 0
    for i, d in enumerate(reversed(digitos)):
        if i % 2 == 1:
            d = d * 2
            if d > 9:
                d -= 9
        soma += d
    return soma % 10 == 0

print(luhn_valido("4242 4242 4242 4242"))  # True
print(luhn_valido("4242 4242 4242 4243"))  # False

Perguntas Frequentes