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

1. Tu aplicación recibe la alerta por webhook
2. Analizas la transacción en tu sistema
3. Llamas a PATCH /chargeback-alert/alerts/:id/status con uno de los tres estados válidos
4. 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).

Autenticación

El callback usa Basic Auth con client_id/client_secret. Ver Autenticación.

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

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:

GET /api/v1/chargeback-alert/alerts

Acepta 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

• Consultar alertas: listar alertas con filtros (incluye búsqueda por tu provider_alert_id).
• Actualizar estado: especificación completa del endpoint de callback.