> ## 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 status da cobrança

> Endpoint ultraleve para checar se a cobrança PIX foi paga sem transferir o objeto inteiro.

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

Endpoint otimizado com latência inferior a 15ms para rotinas de polling no frontend e checkouts transparentes.

### Parâmetros de Rota (Path)

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

### Resposta de Sucesso

<ResponseField name="id" type="string">
  ID da cobrança.
</ResponseField>

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

<ResponseField name="paid" type="boolean">
  `true` caso o pagamento já tenha sido confirmado no Bacen.
</ResponseField>

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

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

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "PAY8829F1A4BC",
    "status": "paid",
    "paid": true,
    "paid_at": "2026-09-30T09:32:15.000Z",
    "amount": 100.00
  }
  ```
</ResponseExample>