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í.
Noviembre de 2026
Sección titulada «Noviembre de 2026»-
Registro de merchants por la API. Consultar, crear o actualizar por el
merchant_ref(el ID del vendedor en tu sistema), por lotes de hasta 500, editar y eliminar. Repetir no duplica: lo que no cambió vuelveunchanged. Listar merchants ganaupdated_aty el filtroupdated_since. -
Enrollments por la API. Solicitar un descriptor o BIN + CAID para un merchant, por lotes de hasta 500 y de varios merchants, listar, consultar y solicitar la desactivación. Toda solicitud pasa por la aprobación del equipo de Rapid. Ver Enrollments: visión general.
-
Uso por merchant: cuántas alertas facturables tuvo cada merchant en el ciclo actual o en un ciclo cerrado.
-
Alertas con tu vendedor. La consulta de alertas trae
merchant_refy filtra pormerchant_id,merchant_ref,merchant_enrollment_idyupdated_since. El webhook en formatov2traemerchant_enrollment_idymerchant.merchant_ref; el formato legacy no cambia. -
Guía de sincronización: el flujo recomendado para mantener vendedores, enrollments y alertas al día, en Guía de sincronización.
-
Errores con
paramsydetails, cuando existen: el campo, el límite o el id en conflicto. Si lees solocodeymessage, nada cambia. Ver Códigos de respuesta. -
La alerta cuya entrega ni siquiera salió se envía después. Si el primer intento de entrega del webhook no llega a salir por una falla del lado de Rapid, la alerta recibida en los últimos 2 días se envía automáticamente más tarde, en general en hasta 20 minutos, con el mismo
alert_id, mientras el webhook esté activo. Trata la entrega repetida por elalert_id(ver Idempotencia). Ver Reintentos y logs. -
Evento de prueba del webhook (
webhook.test): el botón Enviar evento de prueba, en Configuración › Webhook, envía a tu URL un evento con los mismos headers y la misma firma de las entregas reales, sin crear alerta. Ver Payload.
-
El filtro
merchant_idde la consulta de alertas pasa a valer. Antes se ignoraba y la lista venía con todas las alertas; ahora vienen solo las del merchant. Ver Consultar alertas. -
Orden estable en la consulta de alertas: las alertas recibidas en el mismo instante se desempatan por el
id, así que la paginación no repite ni salta alertas. -
El parámetro desconocido en
/merchantsy/chargeback-alert/alertsva a pasar a rechazarse con422, como ya pasa en las rutas nuevas. Por ahora sigue ignorado; confirma que tu integración envía solo los parámetros documentados. -
Dos respuestas a la misma alerta al mismo tiempo no pasan juntas. En Actualizar estado, la primera queda registrada y la otra recibe
422Alert already has a definitive status, igual que quien responde una alerta ya respondida (antes las dos recibían200). Ver Repetir la solicitud. -
Cambio del
client_secretsin interrupción. Generar un secreto nuevo ya no corta el anterior en el momento: sigue valiendo 24 horas, junto con el nuevo, y se puede revocar antes en el panel. Elclient_idno cambia. Ver Cambio delclient_secret.
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 y actualizar. Las transacciones no se pueden eliminar: elDELETEresponde405(ver Eliminar transacción). - 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.