Chave aleatória EVP: a chave Pix em formato UUID

O que é chave aleatória (EVP)

Chave aleatória é a chave Pix gerada pelo próprio DICT no formato UUID, chamada de EVP (Endereço Virtual de Pagamento) na especificação da API do DICT. Ela não carrega CPF, telefone nem e-mail, e na API da xFlow corresponde ao tipo EVP do campo pix_key_type.

Atualizado em 25 de outubro de 2026 · Equipe xFlow Payments

Das cinco chaves Pix, só uma não é escolhida pelo usuário. CPF, CNPJ, telefone e e-mail são dados que a pessoa já tem. A chave aleatória é criada pelo diretório no registro e serve para receber Pix sem expor dados pessoais.

O que dizem as regras

O Regulamento do Pix, aprovado pela Resolução BCB nº 1, de 12/08/2020, no texto em vigor em 25/10/2026, lista a chave aleatória entre as chaves que podem ser vinculadas a uma conta (art. 45). O DICT gera o número antes do registro (art. 58, § 2º). Como a chave nasce no diretório, a validação de posse exigida das outras não se aplica a ela (art. 57, § 1º).
O Manual Operacional do DICT (versão 8.5) define o formato: um UUID gerado pelo DICT, conforme a RFC 4122, no padrão XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. A sequência não tem significado além de servir como chave Pix.
A especificação da API do DICT (versão 2.12.1) chama o tipo de EVP e o valida com a expressão ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$, em hexadecimal minúsculo. Na mesma especificação, a chave EVP não pode ser reivindicada nem levada a outra instituição por portabilidade.

Na API da xFlow

No saque Pix por API, POST /api/v1/transfers aceita pix_key_type: "EVP", que a documentação descreve como chave aleatória no formato UUID. É um dos cinco tipos aceitos, ao lado de CPF, CNPJ, EMAIL e PHONE.

Vale validar a chave antes de chamar a API. Assim um erro de digitação vira uma mensagem clara para o usuário, e não uma tentativa de saque recusada.

Exemplo

const EVP = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;

function normalizarEvp(entrada) {
  const chave = String(entrada).trim().toLowerCase();
  if (!EVP.test(chave)) throw new Error("Chave aleatória inválida");
  return chave;
}

Pela RFC 4122, letras maiúsculas e minúsculas valem o mesmo na entrada de um UUID, por isso converter para minúsculas é seguro. Envie o saque com Idempotency-Key, como explica o verbete de idempotência.

Termos relacionados

DICT: o diretório que gera e guarda a chave aleatória.
Cash-in e cash-out: o saque por chave é a saída de dinheiro da conta.
BR Code: no QR Code estático, a chave fica no campo 26.

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