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

# Obter Cobrança

> Retorna os detalhes de uma cobrança: situação, valores com taxa e líquido, QR Code e data do pagamento.

Retorna os dados de uma cobrança.

<Note>
  Para saber quando uma cobrança foi paga, assine o webhook [`payment.paid`](/api-reference/webhooks/eventos). Consultar em laço gasta requisições do seu limite e atrasa a entrega ao cliente.
</Note>

<Note>
  Para saber quando uma cobrança foi paga, assine o webhook [`payment.paid`](/api-reference/webhooks/eventos). Consultar em laço gasta requisições do seu limite e atrasa a entrega ao cliente.
</Note>

**Método:** `GET /api/v1/transactions/:id`

**Autenticação:** Obrigatória — inclua o header `Authorization: Bearer sk_live_sua_api_key`.

## Parâmetros de caminho

<ParamField path="id" type="string" required>
  UUID da cobrança, devolvido em `data.id` na criação.
</ParamField>

## Exemplo de requisição

```bash theme={null}
curl -X GET 'https://api.bukiopay.com/api/v1/transactions/e19dc9a3-7e3d-4c4a-8e72-9ca5c17540c2' \
  --header 'Authorization: Bearer sk_live_sua_api_key'
```

## Resposta

```json theme={null}
{
  "success": true,
  "data": {
    "id": "e19dc9a3-7e3d-4c4a-8e72-9ca5c17540c2",
    "type": "PIX_IN",
    "status": "COMPLETED",
    "amount": 50,
    "feeAmount": 2.49,
    "netAmount": 47.51,
    "coverFee": false,
    "description": "Mensalidade de agosto",
    "customer": {
      "name": "João Silva",
      "email": "joao@exemplo.com",
      "document": "12345678901"
    },
    "payment": {
      "copyPaste": "00020126580014BR.GOV.BCB.PIX...",
      "qrCodeBase64": "iVBORw0KGgoAAAANSUhEUg...",
      "qrcodeUrl": "data:image/png;base64,iVBORw0KGgo..."
    },
    "externalReference": "2IH180IE",
    "createdAt": "2026-08-26T11:58:00.000Z",
    "paidAt": "2026-08-26T12:00:00.000Z"
  },
  "requestId": "req_a1b2c3d4"
}
```

<Note>
  Valores **em reais**, com decimais. `50` = R\$50,00.
</Note>

## Situações

| Status | Significado |
| - | - |
| `PENDING` | Aguardando pagamento |
| `COMPLETED` | Pago e confirmado |
| `CANCELLED` | Cancelado antes do pagamento |
| `FAILED` | A cobrança não pôde ser gerada |

`paidAt` só vem preenchido quando o status é `COMPLETED`.

## Erros

| Status | Quando acontece |
| - | - |
| `404` | Cobrança não encontrada na sua loja |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.