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

# Verificação de Status Unificado

> Consulta instantânea do status atual de qualquer cobrança ou saque através de um único endpoint leve.

<Info>
  **Como Funciona o Status Unificado?**

  Este endpoint aceita o parâmetro `idtransaction` e busca automaticamente se pertence a uma **Cobrança PIX** ou a um **Saque PIX**, consultando em tempo real:

  `ID Interno (PAY... ou WIT...)` • `ID da Adquirente` • `externalReference (seu ID de pedido)`
</Info>

`GET /v1/status?idtransaction={id}`  •  escopo `payments:read`

### Parâmetros de Query

| Parâmetro       | Tipo   | Obrigatório | Descrição                                                                         |
| --------------- | ------ | ----------- | --------------------------------------------------------------------------------- |
| `idtransaction` | string | **Sim**     | ID da transação (ex: PAY..., WIT..., ID externo do pedido ou txId da adquirente). |

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.kavropay.online/v1/status?idtransaction=PAY9B1DEB4D3B7D4BAD9BDD2B" \
    -H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI"
  ```

  ```javascript Node.js theme={null}
  const id = 'PAY9B1DEB4D3B7D4BAD9BDD2B';
  const res = await fetch(`https://api.kavropay.online/v1/status?idtransaction=${id}`, {
    headers: { 'Authorization': 'Bearer sk_live_SUA_CHAVE_AQUI' }
  });
  const data = await res.json();
  console.log('Status Atual:', data.status); // 'paid', 'waiting_payment', 'paid_out', etc.
  ```

  ```php PHP theme={null}
  <?php
  $id = 'PAY9B1DEB4D3B7D4BAD9BDD2B';
  $ch = curl_init("https://api.kavropay.online/v1/status?idtransaction=" . urlencode($id));
  curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer sk_live_SUA_CHAVE_AQUI']);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  $res = json_decode(curl_exec($ch), true);
  curl_close($ch);
  echo "Status: " . $res['status'];
  ```

  ```python Python theme={null}
  import requests
  id_tx = 'PAY9B1DEB4D3B7D4BAD9BDD2B'
  res = requests.get(f'https://api.kavropay.online/v1/status?idtransaction={id_tx}',
      headers={'Authorization': 'Bearer sk_live_SUA_CHAVE_AQUI'}
  )
  print('Status:', res.json()['status'])
  ```
</CodeGroup>

**Resposta Rápida (HTTP 200 OK)**

```json theme={null}
{
  "id": "PAY9B1DEB4D3B7D4BAD9BDD2B",
  "status": "paid"
}
```

<CardGroup cols={2}>
  <Card title="Anterior: Cobranças PIX" icon="arrow-left" horizontal href="/cobrancas-pix" />

  <Card title="Próximo: Gestão de Clientes" icon="arrow-right" horizontal href="/gestao-clientes" />
</CardGroup>