Ir al contenido

↑↓ navegar ↵ abrir Ctrl↵ nueva pestaña esc cerrar

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

  • 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ó vuelve unchanged. Listar merchants gana updated_at y el filtro updated_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_ref y filtra por merchant_id, merchant_ref, merchant_enrollment_id y updated_since. El webhook en formato v2 trae merchant_enrollment_id y merchant.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 params y details, cuando existen: el campo, el límite o el id en conflicto. Si lees solo code y message, 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 el alert_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_id de 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 /merchants y /chargeback-alert/alerts va a pasar a rechazarse con 422, 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 422 Alert already has a definitive status, igual que quien responde una alerta ya respondida (antes las dos recibían 200). Ver Repetir la solicitud.

  • Cambio del client_secret sin 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. El client_id no cambia. Ver Cambio del client_secret.

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: el DELETE responde 405 (ver Eliminar transacción).
  • Listar merchants, para encontrar el merchant_id por 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). El message viene en inglés; decide por el code (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, con Retry-After en el 429. Ver Códigos de respuesta.
  • Reintentos del webhook con intervalos definidos. Ver Reintentos y logs.

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 anteriorUsar en una integración nueva
POST /chargeback-alert/update/statusPATCH /api/v1/chargeback-alert/alerts/:id/status
POST /chargeback-alert/getGET /api/v1/chargeback-alert/alerts
Webhook en el formato legacy, con clientid/clientkeyWebhook en el formato v2, con firma

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

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.