Ver Transação

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"

const response = await fetch(
  "https://api.avanttifinance.com/v1/transactions/" + transactionId,
  {
    method: "GET",
    headers: {
      Authorization: \`Bearer \${accessToken}\`,
    },
  }
);

const transaction = await response.json();
console.log(transaction);

import requests

url = f"https://api.avanttifinance.com/v1/transactions/{transaction_id}"
headers = {"Authorization": f"Bearer {access_token}"}

response = requests.get(url, headers=headers)
print(response.json())

Parâmetros de path

string

required

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

Resposta

string

Identificador único da transação.

string

Situação atual da transação. Valores possíveis: pending, paid, failed, refunded, canceled.

integer

Valor da transação em centavos.

string

Método de pagamento utilizado: pix, credit_card ou boleto.

object

Dados do cliente associado à transação (nome, e-mail, documento).

string

Data e hora de criação da transação, no formato ISO 8601.

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

Status	Descrição
`pending`	Aguardando pagamento
`paid`	Pagamento confirmado
`failed`	Falha no processamento
`refunded`	Transação reembolsada
`canceled`	Transaçã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 HTTP	Significado
401	Token de autenticação inválido ou ausente
404	Transação não encontrada
500	Erro interno — tente novamente ou contate o suporte

Comece Aqui

Autenticação

Pix In

Cartão de Crédito

Boleto

Pix Out

Link de Pagamento

Transações e Reembolsos

Assinaturas

Gestão de Conta

Webhooks

Desenvolvedores

Visão geral

Consulta em tempo real

Suporte a múltiplos métodos

Endpoint

Parâmetros de path

Resposta

Exemplo de resposta

Status possíveis

Erros comuns

Próximos passos

Reembolsar transação

Listar reembolsos

​Visão geral

Consulta em tempo real

Suporte a múltiplos métodos

​Endpoint

​Parâmetros de path

​Resposta

​Exemplo de resposta

​Status possíveis

​Erros comuns

​Próximos passos

Reembolsar transação

Listar reembolsos

Visão geral

Endpoint

Parâmetros de path

Resposta

Exemplo de resposta

Status possíveis

Erros comuns

Próximos passos