# Novedades de la API

> Qué cambió en la API de integración de Rapid, por fecha: endpoints nuevos, cambios de comportamiento y lo que sigue funcionando del sistema anterior.

Página: https://doc.rapidchargeback.com/es/referencia/novidades-da-api/

Cambios en la API de integración, del más reciente al más antiguo. Los cambios solo en el panel no entran aquí.

## Octubre de 2026: nueva API

La versión actual de la API, que reemplaza la del sistema anterior. Si ya integrabas con Rapid, esta es la lista de lo que cambia.

### Nuevo

- **API de Transacciones** en `/api/v1/transactions`: [crear](https://doc.rapidchargeback.com/es/canais/transactions/criar-transacao/), [enviar por lotes](https://doc.rapidchargeback.com/es/canais/transactions/envio-em-lote/) (hasta 1000 por llamada), [consultar](https://doc.rapidchargeback.com/es/canais/transactions/consultar-transacao/) por el ID de Rapid o por el ID de tu sistema, [actualizar](https://doc.rapidchargeback.com/es/canais/transactions/atualizar-transacao/) y [eliminar](https://doc.rapidchargeback.com/es/canais/transactions/deletar-transacao/).
- **[Listar merchants](https://doc.rapidchargeback.com/es/canais/merchants/listar-merchants/)**, para encontrar el `merchant_id` por la API.
- **[Consultar alertas](https://doc.rapidchargeback.com/es/callback/consultar-alertas/)** con filtros (estado, fechas, tarjeta, ID del proveedor) y paginación.
- **[Actualizar estado](https://doc.rapidchargeback.com/es/callback/atualizar-status/)** de la alerta en `PATCH /api/v1/chargeback-alert/alerts/:id/status`.
- **Webhook en formato `v2`**: entrega [firmada](https://doc.rapidchargeback.com/es/canais/webhook/autenticacao/) con HMAC-SHA256 y timestamp, evento identificado en el cuerpo y en un header, y un solo canal para todos los productos.
- **[Evidencia](https://doc.rapidchargeback.com/es/canais/evidence/visao-geral/) y [Captura](https://doc.rapidchargeback.com/es/canais/capture/visao-geral/)**, que alimentan la defensa de la Disputa.
- **Errores en un formato único** en toda la API, incluso en rutas que no existen (`404 NOT_FOUND`). El `message` viene en inglés; decide por el `code` (ver [Códigos de respuesta](https://doc.rapidchargeback.com/es/referencia/codigos-de-resposta/)).
- **[Herramientas para devs](https://doc.rapidchargeback.com/es/referencia/ferramentas-para-devs/)**: la documentación en tu asistente de IA (MCP), en Markdown y en `llms.txt`, y la colección de Postman.

### Cambió

- **Webhook solo por HTTPS y a una dirección pública de internet.** Una redirección que cambia el POST por GET (`301`, `302`, `303`) no se sigue. Ver [Reintentos y logs](https://doc.rapidchargeback.com/es/canais/webhook/retries-e-logs/).
- **Límite de solicitudes** por IP, que también cuenta las respuestas `401`, con `Retry-After` en el `429`. Ver [Códigos de respuesta](https://doc.rapidchargeback.com/es/referencia/codigos-de-resposta/#rate-limit).
- **Reintentos del webhook** con intervalos definidos. Ver [Reintentos y logs](https://doc.rapidchargeback.com/es/canais/webhook/retries-e-logs/).

### Sigue funcionando, del sistema anterior

Se mantienen para quien ya integraba, sin cambios de tu lado. Para una integración nueva, usa los endpoints de la columna de la derecha.

| Del sistema anterior | Usar en una integración nueva |
|---|---|
| `POST /chargeback-alert/update/status` | [`PATCH /api/v1/chargeback-alert/alerts/:id/status`](https://doc.rapidchargeback.com/es/callback/atualizar-status/) |
| `POST /chargeback-alert/get` | [`GET /api/v1/chargeback-alert/alerts`](https://doc.rapidchargeback.com/es/callback/consultar-alertas/) |
| Webhook en el [formato `legacy`](https://doc.rapidchargeback.com/es/canais/webhook/payload/#formato-legacy), con `clientid`/`clientkey` | Webhook en el formato `v2`, con [firma](https://doc.rapidchargeback.com/es/canais/webhook/autenticacao/) |

Estos endpoints antiguos se eliminarán cuando ya no haya llamadas a ellos.

### Sin equivalente

La **API de Transacciones del sistema anterior** (`/transactions/create`, `/transactions/update` y `/transactions/delete`, sin `/api/v1`) no existe en la nueva API. Cambiaron la ruta y los campos: la integración tiene que pasar a la nueva [API de Transacciones](https://doc.rapidchargeback.com/es/canais/transactions/visao-geral/).