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:

• 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
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.

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.

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: listar alertas com filtros (inclui busca pelo seu provider_alert_id).
• Atualizar status: spec completa do endpoint de callback.