# Visão geral

> Envie, consulte, atualize e remova as transações de venda que alimentam a Prevenção e a Disputa, com Basic Auth e JSON.

Página: https://doc.rapidchargeback.com/canais/transactions/visao-geral/

A API de Transações permite que você envie, consulte, atualize e remova transações de venda da sua empresa na plataforma Rapid. Essas transações são utilizadas pelas soluções contratadas para proteger seu negócio contra disputas e chargebacks.

## Como funciona

1. Sua aplicação envia as transações de venda via HTTPS para a API da Rapid
2. A Rapid armazena os dados da transação (itens, cliente, endereços, pagamentos, reembolsos)
3. As soluções ativas utilizam esses dados automaticamente quando necessário

## Endpoints disponíveis

| Método | Endpoint | Descrição |
|---|---|---|
| POST | `/api/v1/transactions` | Criar uma transação |
| POST | `/api/v1/transactions/batch` | Criar múltiplas transações (até 1000) |
| GET | `/api/v1/transactions/:id` | Consultar uma transação |
| GET | `/api/v1/transactions?external_id=` | Achar uma transação pelo ID do seu sistema |
| PATCH | `/api/v1/transactions/:id` | Atualizar uma transação |
| DELETE | `/api/v1/transactions/:id` | Deletar uma transação |

## Base URL

```
https://api.rapidchargeback.com/api/v1
```

## Autenticação

Todas as requisições exigem autenticação via **Basic Auth**:

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

| Credencial | Descrição |
|---|---|
| `client_id` | ID da sua empresa (fornecido pela Rapid) |
| `client_secret` | Chave secreta da sua empresa (fornecida pela Rapid) |

Exemplo de header:

```
Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ=
```

## Limites

| Limite | Valor |
|---|---|
| Requisições por minuto | 100 por IP |
| Transações por requisição (batch) | 1000 |

## Proteção de imutabilidade

Transações que já foram utilizadas por alguma solução (ex: consultadas pela **Prevenção**) não podem ser alteradas ou deletadas. Nesse caso, a API retorna `409 Conflict`.

Transações que ainda não foram utilizadas podem ser livremente atualizadas ou deletadas.