Pular para o conteúdo
Documentação Rapid

↑↓ navegar ↵ abrir Ctrl↵ nova aba esc fechar

Alerta

Alerta é a solução da Rapid para notificação antecipada de disputas. (Nome anterior: Chargeback Alert. O caminho da API continua /chargeback-alert/....) Quando um portador de cartão abre uma disputa junto ao banco emissor, a rede (Mastercard ou Visa) sinaliza o evento para provedores antes que ele se torne um chargeback formal. A Rapid recebe esses sinais e te entrega o alerta em tempo hábil para você tomar uma ação.

Em payloads e respostas da API, os provedores são identificados pelos slugs ethoca_alerts (Mastercard) e verifi_rdr (Visa).

Dependendo da bandeira, a ação do cliente é diferente:

  • Mastercard (via Ethoca): você tem até 24 horas para confirmar se vai estornar, indicar que a transação já foi resolvida, ou que não encontrou a transação. A sua resposta volta para o Ethoca e pode evitar que a disputa evolua para chargeback.
  • Visa (via Verifi RDR): o estorno já foi feito automaticamente pela adquirente quando o alerta chegou. Não há prazo de resposta; o status é usado apenas para organização interna.

Como funciona

Seção intitulada “Como funciona”
  1. O portador abre uma disputa no banco emissor
  2. A bandeira sinaliza a disputa para o provedor (Ethoca para Mastercard, Verifi RDR para Visa)
  3. O provedor entrega o alerta para a Rapid
  4. A Rapid associa o alerta à sua empresa via descriptor (Ethoca) ou BIN+CAID (Verifi)
  5. A Rapid entrega o alerta para sua aplicação via webhook
  6. Sua aplicação processa o alerta e (no caso Ethoca) retorna um status via API de callback

Para receber alertas, sua empresa precisa ter:

  • Um webhook ativo configurado no painel (ver canal Webhook)
  • Ao menos um descriptor cadastrado (Ethoca) ou BIN+CAID (Verifi) associado à sua empresa

Provedores

Seção intitulada “Provedores”

Ethoca (Mastercard)

Seção intitulada “Ethoca (Mastercard)”

Alertas são associados à sua empresa pelo descriptor, o nome que aparece na fatura do portador. Quando o descriptor do alerta casa com um dos seus cadastrados, o alerta é entregue.

Você tem 24 horas para retornar um status via callback. Se não responder no prazo, o alerta expira automaticamente (status expired) e pode evoluir para chargeback.

Verifi RDR (Visa)

Seção intitulada “Verifi RDR (Visa)”

Alertas são associados pelo BIN + CAID. O estorno já foi aplicado automaticamente quando o alerta chegou. O cliente pode atualizar o status apenas para organizar seu próprio fluxo, mas não há prazo.

Próximos passos

Seção intitulada “Próximos passos”