Uma chave Pix é um apelido para uma conta. O DICT é a lista oficial que liga cada apelido à conta certa. Quando o pagador digita uma chave, o PSP dele consulta o DICT e recebe os dados de quem vai receber, e o pagador confere esses dados antes de confirmar.
O que o DICT faz
A especificação da API do DICT, publicada pelo Banco Central, define o diretório como o serviço do arranjo Pix que permite buscar detalhes de contas transacionais por chaves mais convenientes para quem paga. Os dados devolvidos servem a dois fins: o pagador confirma a identidade do recebedor, e o PSP do pagador monta a ordem de pagamento com os dados da conta. A página Segurança no Pix acrescenta que o DICT também é usado para registrar denúncias de fraude.
Tipos de chave
O Manual Operacional do DICT (versão 8.5, de 01/09/2026) define os formatos:
| Tipo | Formato no DICT |
|---|---|
| Telefone celular | Padrão E.164, com + e código do país. |
| Até 77 caracteres. | |
| CPF | 11 caracteres, sem pontos ou traços. |
| CNPJ | 14 caracteres, sem pontos ou traços. |
| Chave aleatória | UUID gerado pelo próprio DICT. |
O mesmo manual limita a cinco chaves por conta para quem tem CPF e a vinte chaves por conta para quem tem CNPJ.
Na API da xFlow
O DICT não aparece como endpoint na API da xFlow, mas os tipos de chave aparecem no saque. Em POST /api/v1/transfers, o campo pix_key_type aceita CPF, CNPJ, EMAIL, PHONE ou EVP, que é a chave aleatória. São os mesmos cinco tipos do diretório.
Exemplo
Saque para uma chave aleatória:
curl -X POST https://app.xflowpayments.com/api/v1/transfers \
-u "pk_live_...:sk_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: saque-5678" \
-d '{ "amount": 1500, "pix_key": "123e4567-e12b-12d1-a456-426655440000", "pix_key_type": "EVP" }'Os detalhes de taxas, aprovação e status estão em API de saque Pix.
Termos relacionados
- PSP: quem consulta o DICT do lado do pagador.
- BR Code: no QR Code Pix, a chave fica no campo 26.
- End-to-end ID: o identificador do Pix depois que ele é feito.
Conteúdo informativo, atualizado em 25/10/2026. Não substitui orientação jurídica.