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
Seção intitulada “Fluxo resumido”- Sua aplicação recebe o alerta via webhook
- Você analisa a transação no seu sistema
- Você chama
PATCH /chargeback-alert/alerts/:id/statuscom um dos três status válidos - 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), um alerta por vez ou em lote: selecionando na lista de alertas ou enviando uma planilha CSV com o ID do alerta e o status.
Autenticação
Seção intitulada “Autenticação”O callback usa Basic Auth com client_id/client_secret. Ver Autenticação.
Status válidos
Seção intitulada “Status válidos”São três: notfound, account_suspended e other. O que cada um significa, os prazos de cada bandeira e as transições permitidas estão em Regras e prazos.
Consultar alertas
Seção intitulada “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:
/api/v1/chargeback-alert/alertsAceita 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
Seção intitulada “Próximos passos”- Consultar alertas: listar alertas com filtros (inclui busca pelo seu
provider_alert_id). - Atualizar status: spec completa do endpoint de callback.