# Alerta

> Como o Alerta avisa a disputa antes de virar chargeback, como o alerta chega à sua empresa e o que responder em cada bandeira.

Página: https://doc.rapidchargeback.com/produtos/alerta/visao-geral/

**Alerta** é a solução da Rapid para **notificação antecipada de disputas**. (Nome anterior: *Chargeback Alert*. O caminho da API continua `/chargeback-alert/...`.) Quando um portador de cartão abre uma disputa junto ao banco emissor, a rede (Mastercard ou Visa) sinaliza o evento para provedores antes que ele se torne um chargeback formal. A Rapid recebe esses sinais e te entrega o alerta em tempo hábil para você tomar uma ação.

Em payloads e respostas da API, os provedores são identificados pelos slugs `ethoca_alerts` (Mastercard) e `verifi_rdr` (Visa).

Dependendo da bandeira, a ação do cliente é diferente:

- **Mastercard** (via Ethoca): você tem até 24 horas para confirmar se vai estornar, indicar que a transação já foi resolvida, ou que não encontrou a transação. A sua resposta volta para o Ethoca e pode evitar que a disputa evolua para chargeback.
- **Visa** (via Verifi RDR): o estorno já foi feito automaticamente pela adquirente quando o alerta chegou. Não há prazo de resposta; o status é usado apenas para organização interna.

## Como funciona

1. O portador abre uma disputa no banco emissor
2. A bandeira sinaliza a disputa para o provedor (Ethoca para Mastercard, Verifi RDR para Visa)
3. O provedor entrega o alerta para a Rapid
4. A Rapid associa o alerta à sua empresa via `descriptor` (Ethoca) ou BIN+CAID (Verifi)
5. A Rapid entrega o alerta para sua aplicação via webhook
6. Sua aplicação processa o alerta e (no caso Ethoca) retorna um status via API de callback

Para receber alertas, sua empresa precisa ter:
- Um **webhook ativo** configurado no painel (ver [canal Webhook](https://doc.rapidchargeback.com/canais/webhook/visao-geral/))
- Ao menos um **descriptor cadastrado** (Ethoca) ou **BIN+CAID** (Verifi) associado à sua empresa

## Provedores

### Ethoca (Mastercard)

Alertas são associados à sua empresa pelo `descriptor`, o nome que aparece na fatura do portador. Quando o descriptor do alerta casa com um dos seus cadastrados, o alerta é entregue.

Você tem 24 horas para retornar um status via [callback](https://doc.rapidchargeback.com/callback/visao-geral/). Se não responder no prazo, o alerta expira automaticamente (status `expired`) e pode evoluir para chargeback.

### Verifi RDR (Visa)

Alertas são associados pelo BIN + CAID. O estorno já foi aplicado automaticamente quando o alerta chegou. O cliente pode atualizar o status apenas para organizar seu próprio fluxo, mas não há prazo.

## Próximos passos

- [Regras e prazos](https://doc.rapidchargeback.com/produtos/alerta/regras-e-prazos/): detalhes de prazo por bandeira.
- [Canal Webhook](https://doc.rapidchargeback.com/canais/webhook/visao-geral/): como configurar a entrega.
- [Callback de status](https://doc.rapidchargeback.com/callback/visao-geral/): como atualizar o status do alerta.