> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avanttifinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ver Transação

> Consulte os detalhes completos de uma transação específica utilizando seu identificador único

## 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.

<CardGroup cols={2}>
  <Card title="Consulta em tempo real" icon="bolt">
    Os dados retornados refletem o status mais atual da transação no momento da requisição.
  </Card>

  <Card title="Suporte a múltiplos métodos" icon="layer-group">
    Funciona para transações via Pix, cartão de crédito e boleto.
  </Card>
</CardGroup>

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.avanttifinance.com/v1/transactions/{transaction_id} \
    --header "Authorization: Bearer SEU_TOKEN_DE_ACESSO"
  ```

  ```javascript Node.js theme={null}
  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);
  ```

  ```python Python theme={null}
  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())
  ```
</CodeGroup>

## Parâmetros de path

<ParamField path="transaction_id" type="string" required>
  Identificador único da transação, retornado na criação da cobrança (Pix, cartão ou boleto).
</ParamField>

## Resposta

<ResponseField name="id" type="string">
  Identificador único da transação.
</ResponseField>

<ResponseField name="status" type="string">
  Situação atual da transação. Valores possíveis: `pending`, `paid`, `failed`, `refunded`, `canceled`.
</ResponseField>

<ResponseField name="amount" type="integer">
  Valor da transação em centavos.
</ResponseField>

<ResponseField name="payment_method" type="string">
  Método de pagamento utilizado: `pix`, `credit_card` ou `boleto`.
</ResponseField>

<ResponseField name="customer" type="object">
  Dados do cliente associado à transação (nome, e-mail, documento).
</ResponseField>

<ResponseField name="created_at" type="string">
  Data e hora de criação da transação, no formato ISO 8601.
</ResponseField>

<ResponseField name="paid_at" type="string">
  Data e hora em que o pagamento foi confirmado, quando aplicável.
</ResponseField>

### Exemplo de resposta

```json theme={null}
{
  "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 |

<Tip>
  Use o campo `status` para acionar fluxos automáticos, mas recomendamos sempre confirmar mudanças críticas via [Webhooks](/webhook).
</Tip>

## 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 |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Reembolsar transação" icon="rotate-ccw" href="/reembolsar">
    Aprenda a reembolsar uma transação paga.
  </Card>

  <Card title="Listar reembolsos" icon="list" href="/listar-reembolsos">
    Consulte o histórico de reembolsos da sua conta.
  </Card>
</CardGroup>