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

# Consultar Transação

> Consulta os detalhes completos de uma transação específica

## Visão Geral

Este endpoint retorna todos os detalhes de uma transação específica, incluindo informações do cliente, dados de pagamento, status e histórico.

## Endpoint

```
GET https://api.klivopay.com.br/api/public/v1/transactions/{hash}
```

## Parâmetros

<ParamField path="hash" type="string" required>
  Hash identificador único da transação
</ParamField>

<ParamField query="api_token" type="string" required>
  Seu token de autenticação da API KlivoPay
</ParamField>

## Exemplo de Requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET 'https://api.klivopay.com.br/api/public/v1/transactions/abc123def456?api_token=seu_token_aqui'
  ```

  ```javascript JavaScript theme={null}
  const hash = 'abc123def456';
  const apiToken = 'seu_token_aqui';

  const response = await fetch(
    `https://api.klivopay.com.br/api/public/v1/transactions/${hash}?api_token=${apiToken}`
  );
  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  hash_id = 'abc123def456'
  url = f'https://api.klivopay.com.br/api/public/v1/transactions/{hash_id}'
  params = {'api_token': 'seu_token_aqui'}

  response = requests.get(url, params=params)
  print(response.json())
  ```

  ```php PHP theme={null}
  <?php
  $hash = 'abc123def456';
  $apiToken = 'seu_token_aqui';
  $url = "https://api.klivopay.com.br/api/public/v1/transactions/{$hash}?api_token={$apiToken}";

  $response = file_get_contents($url);
  $data = json_decode($response);
  print_r($data);
  ?>
  ```
</CodeGroup>

## Resposta de Sucesso

```json 200 OK theme={null}
{
  "success": true,
  "data": {
    "hash": "abc123def456",
    "status": "paid",
    "amount": 15000,
    "payment_method": "pix",
    "offer": {
      "hash": "offer123",
      "title": "Produto Exemplo",
      "amount": 15000
    },
    "customer": {
      "name": "João Silva",
      "email": "joao@example.com",
      "phone_number": "11987654321",
      "document": "12345678900"
    },
    "cart": [
      {
        "name": "Produto Exemplo",
        "quantity": 1,
        "unit_price": 15000
      }
    ],
    "pix_qr_code": "00020126580014br.gov.bcb.pix...",
    "pix_copy_paste": "00020126580014br.gov.bcb.pix...",
    "created_at": "2025-01-20T10:15:00Z",
    "paid_at": "2025-01-20T10:20:00Z",
    "expires_at": "2025-01-20T10:30:00Z"
  }
}
```

## Códigos de Resposta

<ResponseField name="200" type="OK">
  Transação encontrada e retornada com sucesso
</ResponseField>

<ResponseField name="401" type="Unauthorized">
  Token de API inválido ou ausente
</ResponseField>

<ResponseField name="404" type="Not Found">
  Transação não encontrada
</ResponseField>

<ResponseField name="500" type="Internal Server Error">
  Erro interno do servidor
</ResponseField>

<Tip>
  Use este endpoint para verificar o status de uma transação específica ou obter detalhes para exibir ao cliente.
</Tip>