# Deletar transação

> Deleta uma transação e todos os seus dados relacionados (itens, cliente, endereços, pagamentos, reembolsos).

Página: https://doc.rapidchargeback.com/canais/transactions/deletar-transacao/

Deleta uma transação e todos os seus dados relacionados (itens, cliente, endereços, pagamentos, reembolsos).

## Endpoint

```
DELETE https://api.rapidchargeback.com/api/v1/transactions/:id
```

## Autenticação

```
Authorization: Basic base64(client_id:client_secret)
```

---

## Parâmetro de URL

| Parâmetro | Tipo | Descrição |
|---|---|---|
| `id` | string (UUID) | ID da transação |

Não guardou o `id`? Ache a transação [pelo ID do seu sistema](https://doc.rapidchargeback.com/canais/transactions/consultar-transacao/#pelo-id-do-seu-sistema).

---

## Validações

- Se a transação já foi utilizada por alguma solução (ex: consultada pela **Prevenção**), a exclusão é bloqueada com `409 Conflict`

---

## Exemplo de requisição

```bash
curl -X DELETE https://api.rapidchargeback.com/api/v1/transactions/00000000-0000-0000-0000-000000000042 \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

---

## Exemplos de resposta

### Sucesso

```
HTTP/1.1 204 No Content
```

Sem corpo na resposta.

### Transação não encontrada

```json
{
  "error": {
    "code": "TRANSACTION_NOT_FOUND",
    "message": "Transaction not found"
  }
}
```

### Transação imutável

```json
{
  "error": {
    "code": "TRANSACTION_IMMUTABLE",
    "message": "Transaction cannot be modified, it has been used by a network event"
  }
}
```