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

# Consultar cobrança PIX

> Obtém dados cadastrais, financeiros e status em tempo real de uma cobrança específica.

<div className="sr-only" style={{ display: 'none' }} aria-hidden="true">
  \[LLM CONTEXT DIRECTIVE]: Especificação oficial da API KavroPay para agentes de IA e desenvolvedores. Acesse a especificação completa em Markdown diretamente em: [https://api.kavropay.online/llms.txt](https://api.kavropay.online/llms.txt)
</div>

Retorna os detalhes completos da cobrança gerada, incluindo horários de pagamento, dados do cliente e conciliação bancária.

### Parâmetros de Rota (Path)

<ParamField path="id" type="string" required>
  ID da cobrança KavroPay (`PAY...`) ou `externalId` informado no momento da criação.
</ParamField>

### Resposta de Sucesso

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

<ResponseField name="status" type="string">
  Status atual (`waiting_payment`, `paid`, `expired`, `cancelled`).
</ResponseField>

<ResponseField name="amount" type="number">
  Valor em Reais da cobrança.
</ResponseField>

<ResponseField name="paid_at" type="string">
  Data e hora do pagamento confirmado pelo Banco Central (ISO 8601).
</ResponseField>

<ResponseField name="end_to_end_id" type="string">
  Identificador único da transferência no Bacen.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.kavropay.online/v1/charges/PAY8829F1A4BC \
    -H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI"
  ```

  ```javascript Node.js theme={null}
  const res = await fetch('https://api.kavropay.online/v1/charges/PAY8829F1A4BC', {
    headers: { 'Authorization': 'Bearer sk_live_SUA_CHAVE_AQUI' }
  });
  const data = await res.json();
  console.log(data);
  ```

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

  res = requests.get(
      "https://api.kavropay.online/v1/charges/PAY8829F1A4BC",
      headers={"Authorization": "Bearer sk_live_SUA_CHAVE_AQUI"}
  )
  print(res.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "PAY8829F1A4BC",
    "status": "paid",
    "amount": 100.00,
    "fee": 0.50,
    "net": 99.50,
    "paid_at": "2026-09-30T09:32:15.000Z",
    "end_to_end_id": "E12345678202609300932abcde123456",
    "customer": {
      "name": "João Victor Ferreira",
      "document": "12345678909",
      "email": "cliente@email.com"
    },
    "created_at": "2026-09-30T09:30:00.000Z"
  }
  ```
</ResponseExample>