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”- O portador abre uma disputa no banco emissor
- A bandeira sinaliza a disputa para o provedor (Ethoca para Mastercard, Verifi RDR para Visa)
- O provedor entrega o alerta para a Rapid
- A Rapid associa o alerta à sua empresa via
descriptor(Ethoca) ou BIN+CAID (Verifi) - A Rapid entrega o alerta para sua aplicação via webhook
- 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, pedido no painel ou pela API (ver Pedir enrollment)
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.
Verifi RDR (Visa)
Seção intitulada “Verifi RDR (Visa)”Alertas são associados pelo BIN + CAID.
O prazo e o que responder em cada bandeira estão no começo desta página; o detalhe completo, em Regras e prazos.
Próximos passos
Seção intitulada “Próximos passos”- Regras e prazos: detalhes de prazo por bandeira.
- Canal Webhook: como configurar a entrega.
- Callback de status: como atualizar o status do alerta.