Changelog

Novos recursos

• Consulta prévia de destinatário para transferência interna: Novo endpoint GET /v1/accounts/{accountId}/transfers/internal/lookup/{document} permite consultar o nome do titular antes de executar uma transferência interna por CPF/CNPJ. Útil para exibir uma confirmação ao usuário final.
• O nome é retornado com máscara de privacidade: o primeiro nome é mantido integral, e cada sobrenome é reduzido à primeira letra seguida de ***. Conectores como “de”, “da”, “dos” são preservados.
  • Exemplo: "JOAO DA SILVA PEREIRA" → "JOAO da S*** P***"
• O endpoint retorna também o accountStatus do destinatário no parceiro bancário.

Fluxo recomendado

1. Cliente informa o CPF/CNPJ do destinatário
2. Integrador chama GET /transfers/internal/lookup/{document} e exibe o maskedName para confirmação
3. Usuário confirma
4. Integrador chama POST /transfers/internal/by-document para executar a transferência

---