# Visão geral

> Após receber um alerta via webhook, sua aplicação retorna um status para a Rapid informando o resultado da análise:

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

Após receber um alerta via webhook, sua aplicação retorna um **status** para a Rapid informando o resultado da análise:

- **Ethoca (Mastercard)**: obrigatório em até 24h. A resposta volta para o Ethoca e pode evitar que a disputa vire chargeback.
- **Verifi RDR (Visa)**: opcional. O estorno já foi feito automaticamente; o status é só para sua organização interna.

## Fluxo resumido

1. Sua aplicação recebe o alerta via [webhook](https://doc.rapidchargeback.com/canais/webhook/visao-geral/)
2. Você analisa a transação no seu sistema
3. Você chama `PATCH /chargeback-alert/alerts/:id/status` com um dos três status válidos
4. A Rapid processa, armazena e (no caso Ethoca) reencaminha ao provedor

Alternativamente, você pode atualizar o status diretamente pelo painel da Rapid (útil para operações manuais).

## Autenticação

O callback usa **Basic Auth** com `client_id`/`client_secret`. Ver [Autenticação](https://doc.rapidchargeback.com/referencia/autenticacao/).

## Status válidos

| Status | Significado |
|---|---|
| `notfound` | Transação não foi encontrada no seu sistema |
| `account_suspended` | Transação encontrada e já resolvida |
| `other` | Transação encontrada, mas ainda não resolvida |

Para prazos e regras de transição, ver [Regras e prazos](https://doc.rapidchargeback.com/produtos/alerta/regras-e-prazos/).

## Consultar alertas

Se sua integração precisa buscar alertas (ex: confirmar se um alerta com determinado `provider_alert_id` chegou, ou paginar histórico), use o endpoint de listagem:

```
GET /api/v1/chargeback-alert/alerts
```

Aceita filtros por `status`, `provider_alert_id`, intervalo de datas, BIN e final do cartão. Útil quando você só tem o ID do provedor (Ethoca/Verifi) e precisa achar o ID interno da Rapid para atualizar o status.

## Próximos passos

- [Consultar alertas](https://doc.rapidchargeback.com/callback/consultar-alertas/): listar alertas com filtros (inclui busca pelo seu `provider_alert_id`).
- [Atualizar status](https://doc.rapidchargeback.com/callback/atualizar-status/): spec completa do endpoint de callback.