Reglas y plazos

Estados posibles

Toda alerta nace con el estado pending y cambia según la respuesta del cliente o el paso del tiempo.

Estados que puedes enviar por el callback

Estado	Cuándo usarlo
`notfound`	La transacción no se encontró en tu sistema
`account_suspended`	La transacción se encontró y ya está resuelta (ej.: cuenta suspendida, reembolso hecho)
`other`	La transacción se encontró, pero todavía no está resuelta

Ver Actualizar estado para los detalles del endpoint.

Estados visibles en el payload del webhook

Además de los tres de arriba que envías tú, el estado de la alerta en el webhook puede aparecer como:

Estado	Significado
`pending`	Estado inicial de toda alerta recibida
`expired`	Alerta de Ethoca cuyo plazo pasó sin respuesta

Plazos por proveedor

Llega la alerta pending

Respondes en hasta 24 horas

notfound definitivo
account_suspended definitivo
other puede pasar a account_suspended en hasta 6 días

Nadie responde en 24 horas

expired definitivo; la disputa sigue y suele convertirse en contracargo

Alertas de Mastercard (Ethoca). En las de Visa (Verifi RDR) el reembolso ya se hizo: no hay plazo, cualquier estado vale en cualquier momento y la alerta no expira.

Ethoca (Mastercard)

Plazo para responder: 24 horas desde la recepción.

Debes enviar notfound, account_suspended u other por el callback dentro de ese plazo
Si el plazo pasa sin respuesta, la alerta pasa a expired automáticamente. Ethoca lo entiende como inacción y la disputa sigue su curso normal (generalmente se convierte en contracargo).

Conversión other → account_suspended: hasta 6 días

Si enviaste other al principio porque todavía estabas investigando, puedes actualizarlo después a account_suspended en hasta 6 días desde la alerta original
Es la única transición permitida después de una respuesta inicial

Los estados definitivos no se pueden cambiar:

notfound es definitivo
account_suspended es definitivo
expired es definitivo

Verifi RDR (Visa)

Sin plazo obligatorio.

El adquirente ya hizo el reembolso automáticamente antes incluso de que llegara la alerta
El estado que envías sirve solo para organización interna en el panel
Puedes enviar cualquiera de los tres estados (notfound, account_suspended, other) en cualquier momento

Vencimiento

Rapid marca las alertas de Ethoca como expired automáticamente después de 24 h sin respuesta. Las alertas de Verifi RDR no vencen: quedan disponibles en el panel indefinidamente.

Reenvío

Si la entrega del webhook falla, Rapid hace hasta 4 intentos (1 inicial + 3 reintentos) con intervalos de 5, 15 y 30 minutos (ver Reintentos y logs). Si todos los intentos fallan, la alerta sigue disponible en el panel y puedes reenviarla desde ahí (ver Reenvío manual).

Las alertas reenviadas mantienen el mismo alert_id, por eso tu aplicación tiene que ser idempotente.