Alerta

Alerta es la solución de Rapid para la notificación anticipada de disputas. (Nombre anterior: Chargeback Alert. La ruta de la API sigue siendo /chargeback-alert/....) Cuando un titular de tarjeta abre una disputa con el banco emisor, la red (Mastercard o Visa) avisa del evento a los proveedores antes de que se convierta en un contracargo formal. Rapid recibe esas señales y te entrega la alerta a tiempo para que actúes.

En los payloads y respuestas de la API, los proveedores se identifican con los slugs ethoca_alerts (Mastercard) y verifi_rdr (Visa).

Lo que tienes que hacer depende de la red de tarjetas:

• Mastercard (vía Ethoca): tienes hasta 24 horas para confirmar si vas a reembolsar, indicar que la transacción ya se resolvió o que no encontraste la transacción. Tu respuesta vuelve a Ethoca y puede evitar que la disputa se convierta en contracargo.
• Visa (vía Verifi RDR): el adquirente ya hizo el reembolso automáticamente cuando llegó la alerta. No hay plazo de respuesta; el estado se usa solo para organización interna.

Cómo funciona

1. El titular abre una disputa con el banco emisor
2. La red de tarjetas avisa de la disputa al proveedor (Ethoca para Mastercard, Verifi RDR para Visa)
3. El proveedor entrega la alerta a Rapid
4. Rapid asocia la alerta a tu empresa por el descriptor (Ethoca) o BIN+CAID (Verifi)
5. Rapid entrega la alerta a tu aplicación por webhook
6. Tu aplicación procesa la alerta y (en el caso de Ethoca) devuelve un estado por la API de callback

Para recibir alertas, tu empresa necesita:

• Un webhook activo configurado en el panel (ver canal Webhook)
• Al menos un descriptor registrado (Ethoca) o BIN+CAID (Verifi) asociado a tu empresa

Proveedores

Ethoca (Mastercard)

Las alertas se asocian a tu empresa por el descriptor, el nombre que aparece en el resumen de la tarjeta del titular. Cuando el descriptor de la alerta coincide con uno de los tuyos, la alerta se entrega.

Verifi RDR (Visa)

Las alertas se asocian por BIN + CAID.

El plazo y qué responder en cada red de tarjetas están al principio de esta página; el detalle completo, en Reglas y plazos.

Próximos pasos

• Reglas y plazos: detalle de plazos por red de tarjetas.
• Canal Webhook: cómo configurar la entrega.
• Callback de estado: cómo actualizar el estado de la alerta.