Valida uma chave Pix no DICT (Diretório de Identificadores de Contas
Transacionais) e retorna os dados públicos do recebedor (nome,
instituição, CPF/CNPJ mascarado). Pré-requisito comum antes de iniciar
uma transferência Pix por chave.

Recomendação fortemente sugerida: envie keyType explícito. O app
normalmente já sabe qual tipo o usuário selecionou (tab CPF/CNPJ/Email/
Phone/EVP). Sem keyType, o backend tenta inferir pelo formato, o que
é ambíguo em CPF×celular (ambos com 11 dígitos numéricos).

Sobre os dados bancários do recebedor (ispb, bankAccountNumber,
bankBranchNumber, bankAccountType): a Autra retorna esses campos
criptografados (RSA) por privacidade — nossa API filtra esses valores
antes de devolver.

App NÃO precisa enviar bank no /pix-payments: basta passar
creditParty.key. O backend Autra faz o DICT lookup internamente,
preenche credit_party.bank + end_to_end_id (ISPB do destino,
exigência BACEN) e envia para a Autra. Para a UI de confirmação
usuário→destino, holderName + bankName + nationalRegistrationMask
é o suficiente (padrão de mercado — Santander, PicPay, etc.).