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í.

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_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.