Novedades de la 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
Sección titulada «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.
- API de Transacciones en
/api/v1/transactions: crear, enviar por lotes (hasta 1000 por llamada), consultar por el ID de Rapid o por el ID de tu sistema, actualizar y eliminar. - Listar merchants, para encontrar el
merchant_idpor la API. - Consultar alertas con filtros (estado, fechas, tarjeta, ID del proveedor) y paginación.
- Actualizar estado de la alerta en
PATCH /api/v1/chargeback-alert/alerts/:id/status. - Webhook en formato
v2: entrega firmada con HMAC-SHA256 y timestamp, evento identificado en el cuerpo y en un header, y un solo canal para todos los productos. - Evidencia y Captura, 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). Elmessageviene en inglés; decide por elcode(ver Códigos de respuesta). - Herramientas para devs: la documentación en tu asistente de IA (MCP), en Markdown y en
llms.txt, y la colección de Postman.
- 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. - Límite de solicitudes por IP, que también cuenta las respuestas
401, conRetry-Afteren el429. Ver Códigos de respuesta. - Reintentos del webhook con intervalos definidos. Ver Reintentos y logs.
Sigue funcionando, del sistema anterior
Sección titulada «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 |
POST /chargeback-alert/get | GET /api/v1/chargeback-alert/alerts |
Webhook en el formato legacy, con clientid/clientkey | Webhook en el formato v2, con firma |
Estos endpoints antiguos se eliminarán cuando ya no haya llamadas a ellos.
Sin equivalente
Sección titulada «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.