Skip to main content

​
Visão geral

Este endpoint retorna todos os detalhes de uma transação específica, incluindo status, valor, método de pagamento, dados do cliente e histórico de eventos.

Consulta em tempo real

Os dados retornados refletem o status mais atual da transação no momento da requisição.

Suporte a múltiplos métodos

Funciona para transações via Pix, cartão de crédito e boleto.

​
Endpoint

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

​
Parâmetros de path

​
transaction_id
string
required
Identificador único da transação, retornado na criação da cobrança (Pix, cartão ou boleto).

​
Resposta

​
id
string
Identificador único da transação.
​
status
string
Situação atual da transação. Valores possíveis: pending, paid, failed, refunded, canceled.
​
amount
integer
Valor da transação em centavos.
​
payment_method
string
Método de pagamento utilizado: pix, credit_card ou boleto.
​
customer
object
Dados do cliente associado à transação (nome, e-mail, documento).
​
created_at
string
Data e hora de criação da transação, no formato ISO 8601.
​
paid_at
string
Data e hora em que o pagamento foi confirmado, quando aplicável.

​
Exemplo de resposta

{
  "id": "txn_8f3a1b2c9d",
  "status": "paid",
  "amount": 15000,
  "payment_method": "pix",
  "customer": {
    "name": "Maria da Silva",
    "email": "maria@exemplo.com",
    "document": "123.456.789-00"
  },
  "created_at": "2026-06-10T14:32:00Z",
  "paid_at": "2026-06-10T14:33:12Z"
}

​
Status possíveis

StatusDescrição
pendingAguardando pagamento
paidPagamento confirmado
failedFalha no processamento
refundedTransação reembolsada
canceledTransação cancelada antes do pagamento
Use o campo status para acionar fluxos automáticos, mas recomendamos sempre confirmar mudanças críticas via Webhooks.

​
Erros comuns

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

​
Próximos passos

Reembolsar transação

Aprenda a reembolsar uma transação paga.

Listar reembolsos

Consulte o histórico de reembolsos da sua conta.