Skip to main content

​
Visão geral

Este endpoint retorna os detalhes completos de uma transferência (Pix Out) realizada a partir da sua conta, incluindo status, valor, dados do destinatário e comprovante.

​
Endpoint

curl --request GET \
  --url https://api.avanttifinance.com/v1/transfers/{transfer_id} \
  --header "Authorization: Bearer SEU_TOKEN_DE_ACESSO"

​
Parâmetros de path

​
transfer_id
string
required
Identificador único da transferência, retornado no momento da criação do Pix Out.

​
Resposta

​
id
string
Identificador único da transferência.
​
status
string
Situação atual da transferência. Valores possíveis: pending, processing, completed, failed.
​
amount
integer
Valor transferido, em centavos.
​
pix_key
string
Chave Pix do destinatário utilizada na transferência.
​
recipient
object
Dados do destinatário (nome e instituição financeira).
​
end_to_end_id
string
Identificador End-to-End (E2E) gerado pelo Banco Central, disponível após a conclusão.
​
created_at
string
Data e hora de criação da transferência, no formato ISO 8601.

​
Exemplo de resposta

{
  "id": "trf_4d2f1a9c7b",
  "status": "completed",
  "amount": 50000,
  "pix_key": "12345678900",
  "recipient": {
    "name": "João Pereira",
    "bank": "Banco Exemplo S.A."
  },
  "end_to_end_id": "E12345678202606101430abc123def",
  "created_at": "2026-06-10T14:28:00Z"
}

​
Status possíveis

StatusDescrição
pendingTransferência criada, aguardando processamento
processingEm processamento junto ao Banco Central
completedTransferência concluída com sucesso
failedFalha na transferência (saldo insuficiente, chave inválida, etc.)
Para acompanhar mudanças de status sem precisar consultar este endpoint repetidamente, configure um Webhook de Pix Out.

​
Erros comuns

Código HTTPSignificado
401Token de autenticação inválido ou ausente
404Transferência não encontrada
500Erro interno — tente novamente ou contate o suporte

​
Próximos passos

Listar transferências

Consulte o histórico completo de transferências Pix Out.

Pix Out

Saiba como criar uma nova transferência Pix Out.