Pular para o conteúdo
xFlow Payments

Glossário

O que é DICT

DICT é o Diretório de Identificadores de Contas Transacionais, o serviço do Pix que guarda as chaves Pix e devolve os dados da conta de quem vai receber. É ele que permite pagar com CPF, CNPJ, telefone, e-mail ou chave aleatória, sem digitar agência e conta.

Atualizado em · Equipe xFlow Payments

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.
E-mail 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:

bash
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.

Continue lendo