Pular para o conteúdo

↑↓ navegar ↵ abrir Ctrl↵ nova aba esc fechar

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.
  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), 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.

O callback usa Basic Auth com client_id/client_secret. Ver Autenticação.

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.

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.