Validador de chave Pix

Os formatos que o DICT aceita

O Manual Operacional do DICT define como cada tipo de chave é guardado, e a especificação da API do DICT traz as expressões regulares:

A expressão regular só confere o formato. CPF e CNPJ também têm dígitos verificadores, e o validador acima confere os dois.

CNPJ alfanumérico

Desde julho de 2026, a Receita Federal pode emitir CNPJ com letras nas 12 primeiras posições; os números já existentes não mudam. O DICT passou a aceitar a chave CNPJ nesse formato. Para os dígitos verificadores, o manual de cálculo da Receita Federal troca cada caractere pelo código ASCII menos 48 (A vale 17, B vale 18) e aplica o módulo 11 com pesos de 2 a 9, da direita para a esquerda:

// Dígitos verificadores do CNPJ numérico ou alfanumérico (ex.: "12ABC34501DE" -> "35").
function dvCnpj(base12) {
  const v = [...base12.toUpperCase()].map((c) => c.charCodeAt(0) - 48);
  const dv = (n) => {
    let soma = 0, peso = 2;
    for (let i = n - 1; i >= 0; i--) { soma += v[i] * peso; peso = peso === 9 ? 2 : peso + 1; }
    const resto = soma % 11;
    return resto < 2 ? 0 : 11 - resto;
  };
  v.push(dv(12));
  v.push(dv(13));
  return `${v[12]}${v[13]}`;
}

Se o seu sistema guarda o CNPJ como número, ele vai recusar o novo formato: troque o campo para texto antes de receber cadastros novos.

Validar antes de pagar

Numa integração de saque, valide a chave antes de chamar a API, para devolver o erro ao usuário na hora e não gastar uma requisição. Depois, a resposta da instituição confirma se a chave existe. Veja como montar o saque em API de saque Pix e o que é o diretório de chaves em DICT.

Conteúdo informativo, atualizado em 25/10/2026. Não substitui orientação jurídica.