Visión general
Después de recibir una alerta por webhook, tu aplicación devuelve un estado a Rapid con el resultado de su análisis:
- Ethoca (Mastercard): obligatorio en hasta 24 h. La respuesta vuelve a Ethoca y puede evitar que la disputa se convierta en contracargo.
- Verifi RDR (Visa): opcional. El reembolso ya se hizo automáticamente; el estado es solo para tu organización interna.
Flujo resumido
Sección titulada «Flujo resumido»- Tu aplicación recibe la alerta por webhook
- Analizas la transacción en tu sistema
- Llamas a
PATCH /chargeback-alert/alerts/:id/statuscon uno de los tres estados válidos - Rapid lo procesa, lo guarda y (en el caso de Ethoca) lo reenvía al proveedor
También puedes actualizar el estado directamente en el panel de Rapid (útil para operaciones manuales), una alerta a la vez o en lote: seleccionándolas en la lista de alertas o subiendo un archivo CSV con el ID de la alerta y el estado.
Autenticación
Sección titulada «Autenticación»El callback usa Basic Auth con client_id/client_secret. Ver Autenticación.
Estados válidos
Sección titulada «Estados válidos»Son tres: notfound, account_suspended y other. Qué significa cada uno, los plazos de cada red de tarjetas y las transiciones permitidas están en Reglas y plazos.
Consultar alertas
Sección titulada «Consultar alertas»Si tu integración necesita buscar alertas (ej.: confirmar si llegó una alerta con un provider_alert_id dado, o paginar el historial), usa el endpoint de listado:
/api/v1/chargeback-alert/alertsAcepta filtros por status, provider_alert_id, rango de fechas, BIN y últimos dígitos de la tarjeta. Útil cuando solo tienes el ID del proveedor (Ethoca/Verifi) y necesitas encontrar el ID interno de Rapid para actualizar el estado.
Próximos pasos
Sección titulada «Próximos pasos»- Consultar alertas: listar alertas con filtros (incluye búsqueda por tu
provider_alert_id). - Actualizar estado: especificación completa del endpoint de callback.