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

# Cancelar Cobrança

> Cancela uma cobrança Pix que ainda não foi paga.

Cancela uma cobrança pendente. Depois disso o QR Code e o Copia e Cola deixam de ser aceitos.

**Método:** `DELETE /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.
</ParamField>

<Warning>
  Uma cobrança já paga não pode ser cancelada. Para devolver o valor de uma venda confirmada, use o reembolso do pedido.
</Warning>

## Exemplo de requisição

```bash theme={null}
curl -X DELETE '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,
  "message": "Transação cancelada com sucesso",
  "data": {
    "id": "e19dc9a3-7e3d-4c4a-8e72-9ca5c17540c2",
    "status": "CANCELLED"
  },
  "requestId": "req_a1b2c3d4"
}
```

## Erros

| Status | Quando acontece |
| - | - |
| `400` | A cobrança já foi paga |
| `404` | Cobrança não encontrada na sua loja |


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