# Visión general

> El callback de estado: la respuesta que tu aplicación devuelve a Rapid después de analizar una alerta, y cuándo es obligatoria.

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

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](https://doc.rapidchargeback.com/es/canais/webhook/visao-geral/)
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), una alerta a la vez o en lote: seleccionándolas en la lista de alertas o subiendo un archivo CSV con el ID de la alerta y el estado.

## Autenticación

El callback usa **Basic Auth** con `client_id`/`client_secret`. Ver [Autenticación](https://doc.rapidchargeback.com/es/referencia/autenticacao/).

## 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](https://doc.rapidchargeback.com/es/produtos/alerta/regras-e-prazos/).

## 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](https://doc.rapidchargeback.com/es/callback/consultar-alertas/): listar alertas con filtros (incluye búsqueda por tu `provider_alert_id`).
- [Actualizar estado](https://doc.rapidchargeback.com/es/callback/atualizar-status/): especificación completa del endpoint de callback.