Changelog

April 18, 2026

v1.29.0 — Lookup internal transfer recipient by document

New Features

  • Recipient preview for internal transfers: New endpoint GET /v1/accounts/{accountId}/transfers/internal/lookup/{document} lets you preview the holder name before executing an internal transfer by CPF/CNPJ. Useful for showing a confirmation step to the end user.
  • The name is returned with a privacy mask: the first name is kept in full; remaining surnames are reduced to their first letter followed by ***. Connectors like “de”, “da”, “dos” are preserved.
    • Example: "JOAO DA SILVA PEREIRA" → "JOAO da S*** P***"
  • The endpoint also returns the accountStatus at the banking partner.
  1. User enters the recipient’s CPF/CNPJ
  2. Integrator calls GET /transfers/internal/lookup/{document} and shows maskedName for confirmation
  3. User confirms
  4. Integrator calls POST /transfers/internal/by-document to execute the transfer