Validador de cartão PAN indiano

Cadeias completamente malformadas falham com invalid_input em vez de inventar um número. Use grátis no navegador ou chame a API do KIT ao preço publicado; ambos os caminhos aplicam as mesmas regras determinísticas sem chamada de rede a NSDL ou UTIITSL.

Como um PAN indiano é estruturado e o que o quarto caractere significa

Quando o padrão coincide e o quarto caractere é um dos dez códigos conhecidos, valid é true e entity_type nomeia a classe. Quando o padrão coincide mas a quarta letra não é um código de entidade reconhecido, valid é false e entity_type é Unknown para que o chamador destaque o quarto caractere sem tratar toda a cadeia como lixo. Entrada completamente quebrada nunca devolve um PAN sintético; lança invalid_input com uma mensagem que indica o problema de comprimento ou de classe de caractere.

Contrato de entrada, campos de resposta e como a validação se comporta

Espaços, pontos, hífens, underscores e barras são removidos e as letras passam a maiúsculas antes da checagem do padrão, de modo que valores como AAAPL um dois três quatro C ou AAA-PL-1234-C ainda fazem parse. Após a normalização, o motor exige a expressão regular de cinco letras maiúsculas, quatro dígitos e uma letra maiúscula. Envie por POST um corpo JSON com um campo de string obrigatório chamado pan. Os aliases text, input, value, number, s e id são aceitos para que clientes leves e caixas de texto genéricas reutilizem o mesmo endpoint sem renomear campos. Em caso de sucesso, a resposta ecoa o input original aparado, a string pan limpa, um campo formatted de exibição com espaços ao redor do bloco de dígitos, valid true ou false, entity_code como o único quarto caractere, entity_type como o rótulo em inglês decodificado, series como as três primeiras letras, name_initial como o quinto caractere, sequence como os quatro dígitos, check_letter como o décimo caractere, length dez, scheme pan_india e entity_codes listando o alfabeto oficial do quarto caractere para legendas no cliente. Strings vazias, pan ausente, números puros, comprimentos errados, caracteres ilegais misturados e padrões que não sejam cinco-mais-quatro-mais-um lançam invalid_input e não são faturados. Como o caminho é parse puro, sem relógio, fonte aleatória nem rede, a mesma entrada sempre produz o mesmo JSON na ferramenta gratuita do navegador e na API. Chamadas bem-sucedidas custam o preço base publicado de US$ 0,002 por item; a ferramenta no navegador permanece gratuita para checagens interativas. Prefira este endpoint especializado quando precisar do tipo de entidade decodificado no corpo da resposta, não apenas um booleano de um verificador genérico multi-país de IDs fiscais.

Onde checagens de formato PAN cabem em KYC, folha e pipelines de dados

Formulários de onboarding e KYC para clientes indianos costumam pedir que o usuário digite um PAN antes da assinatura eletrônica ou da vinculação bancária. Sites de conteúdo que ranqueiam por validador de cartão pan indiano ou verificador de formato pan se beneficiam de uma ferramenta ao vivo cujo caminho gratuito no navegador coincide byte a byte com a automação paga. Não trate uma checagem estrutural aprovada como prova de identidade, de alocação, de status de declaração fiscal ou de autorização para agir em nome de alguém: ela só prova que a string de dígitos e letras é coerente com o layout público do PAN e com um código de tipo de entidade reconhecido. Validar o padrão de dez caracteres e a letra de tipo de entidade na borda do navegador ou da API bloqueia erros óbvios de digitação antes de gravar um registro e antes de chamar qualquer serviço fiscal ou de pagamentos posterior. Importações de folha e RH recebem identificadores de funcionários de planilhas em que um único dígito trocado rejeitaria um lote inteiro; um oráculo determinístico que devolve pan, valid e entity_type permite marcar linhas sem chamar portais governamentais a cada linha. Testes de integração de pipelines OCR podem afirmar que uma string limpa de dez caracteres ou valida, ou é rejeitada com uma mensagem clara invalid_input quando ainda há ruído.