# Visión general

> Envía, consulta, actualiza y elimina las transacciones de venta que alimentan la Prevención y la Disputa, con Basic Auth y JSON.

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

La API de Transacciones te permite enviar, consultar, actualizar y eliminar las transacciones de venta de tu empresa en la plataforma Rapid. Las soluciones contratadas usan estas transacciones para proteger tu negocio contra disputas y contracargos.

## Cómo funciona

1. Tu aplicación envía las transacciones de venta por HTTPS a la API de Rapid
2. Rapid almacena los datos de la transacción (ítems, cliente, direcciones, pagos, reembolsos)
3. Las soluciones activas usan estos datos automáticamente cuando hace falta

## Endpoints disponibles

| Método | Endpoint | Descripción |
|---|---|---|
| POST | `/api/v1/transactions` | Crear una transacción |
| POST | `/api/v1/transactions/batch` | Crear varias transacciones (hasta 1000) |
| GET | `/api/v1/transactions/:id` | Consultar una transacción |
| GET | `/api/v1/transactions?external_id=` | Encontrar una transacción por el ID de tu sistema |
| PATCH | `/api/v1/transactions/:id` | Actualizar una transacción |
| DELETE | `/api/v1/transactions/:id` | Eliminar una transacción |

## Base URL

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

## Autenticación

Todas las solicitudes usan **Basic Auth** con el `client_id` y el `client_secret` generados en el panel. Cómo generarlos y enviarlos está en [Autenticación](https://doc.rapidchargeback.com/es/referencia/autenticacao/).

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

## Límites

| Límite | Valor |
|---|---|
| Solicitudes por minuto | 100 por IP |
| Transacciones por solicitud (batch) | 1000 |

## Protección de inmutabilidad

Las transacciones que ya fueron usadas por alguna solución (ej.: consultadas por la **Prevención**) no se pueden modificar ni eliminar. En ese caso, la API devuelve `409 Conflict`.

Las transacciones que todavía no fueron usadas se pueden actualizar o eliminar libremente.