Pular para o conteúdo

↑↓ navegar ↵ abrir Ctrl↵ nova aba esc fechar

Se sua aplicação responder com qualquer código diferente de 2xx, ou não responder dentro do timeout, a Rapid considera a tentativa como falha e reenvia o webhook.

São 4 tentativas no total: a inicial e mais 3, cada uma esperando mais que a anterior.

  1. Na hora 1ª tentativa, assim que o evento é enfileirado
  2. +5 min 2ª tentativa, 5 minutos depois da falha anterior (5 minutos desde o início)
  3. +15 min 3ª tentativa (20 minutos desde o início)
  4. +30 min 4ª e última tentativa (50 minutos desde o início)

Se a 4ª também falhar, a entrega é encerrada e o alerta fica disponível no painel para ação manual (ver Reenvio manual).

Se a primeira tentativa nem chegar a sair por uma falha do lado da Rapid, o alerta é enviado automaticamente mais tarde, em geral em até 20 minutos, com o mesmo alert_id. Isso vale para alertas recebidos nos últimos 2 dias, enquanto o webhook estiver ativo; o que chegou com o webhook desligado não é enviado depois.

Cada tentativa tem timeout de 30 segundos. Se sua aplicação não responder nesse prazo, a tentativa é considerada falha.

Qualquer código 2xx: 200, 201, 202, 204 e os demais da faixa. O corpo da resposta é opcional.

Qualquer outro código (incluindo 4xx e 5xx) dispara retentativa.

Cadastre a URL final. A Rapid trata redirecionamento assim:

Resposta da sua URLO que acontece
301, 302, 303Falha. Esses códigos trocam o POST por GET e descartam o corpo, então segui-los seria entregar nada. A tentativa entra na retentativa e o log mostra para onde a sua URL redireciona.
307, 308 para o mesmo domínioSeguido, com o POST, o corpo e os headers intactos. Até 3 redirecionamentos seguidos.
307, 308 para outro domínioFalha. O payload assinado não sai do domínio que você cadastrou.

Os casos comuns são o servidor acrescentar / no fim do caminho e trocar de domínio, como de exemplo.com para www.exemplo.com (que conta como outro domínio). No log de entregas o motivo aparece começando com [redirecionamento], junto com o endereço de destino.

Se o endereço cadastrado não resolve para um endereço público de internet (aponta para rede local ou privada, ou o domínio não existe), a entrega falha sem nenhuma requisição e entra no fluxo normal de retentativas. No log de entregas o motivo aparece começando com [destino]. Corrija a URL ou o DNS do domínio; veja Use um endereço público de internet.

Se o motivo começa com [https], a URL cadastrada não usa HTTPS e a Rapid não entrega em texto aberto: cadastre uma URL https://.

Se o motivo começa com [assinatura], a falha é do lado da Rapid: a entrega não sai sem assinatura, e é tentada de novo automaticamente. Não é preciso fazer nada no seu sistema.

Se a empresa está bloqueada por inadimplência na Rapid, o fluxo de webhooks continua normal: alertas seguem sendo recebidos dos provedores, armazenados e entregues à URL configurada. O painel continua disponível. O que o bloqueio corta é a API por credencial (leitura e escrita: GET/PATCH /chargeback-alert/alerts, transações, merchants, aliases legados), que passa a responder 403 COMPANY_BLOCKED, e a defesa das disputas, inclusive as que já estavam em andamento.

Para interromper o recebimento de novos alertas, é necessário desativar o cadastro diretamente no provedor (ação operada pela equipe da Rapid).

Toda tentativa é registrada internamente com:

  • Evento entregue (chargeback_alert.received, dispute.fraud.revoke_access, webhook.test)
  • Data/hora da tentativa
  • URL de destino
  • Código HTTP da resposta
  • Corpo da resposta (truncado em 1000 caracteres; resposta com mais de 64 KB não é guardada)
  • Número da tentativa

Você vê esses registros no painel da Rapid em dois lugares: em Configurações › Webhook, no Histórico de entregas, que filtra por resultado (só as falhas, por exemplo) e por período; e em Atividade, aba Webhooks, que também filtra pelo alerta e aparece para os papéis Proprietário, Administrador, Desenvolvedor e Auditor. Quando a falha não chegou ao seu servidor, o painel mostra a explicação do motivo; o texto original, que começa com [https], [destino], [redirecionamento] ou [assinatura], aparece ao passar o mouse.

Quando todas as tentativas automáticas falham, o alerta continua no painel. Para mandar de novo, use o botão Tentar novamente no Histórico de entregas, em Configurações › Webhook. A entrega reenviada chega como um novo webhook com o mesmo alert_id, por isso idempotência é essencial.

O botão não aparece na tentativa que falhou se o mesmo alerta foi entregue numa tentativa seguinte. Se o reenvio não puder sair naquele momento, o painel avisa, e basta tentar de novo em instantes.

Depois de uma queda do seu endpoint, use Reenviar falhas, no Histórico de entregas, com o webhook ativo. Escolha o período e a Rapid manda de novo, de uma vez, os alertas com entrega que falhou nesse período e que ainda não chegaram ao seu sistema (o alerta que já foi entregue alguma vez fica de fora; para ele, use o Tentar novamente da linha).

  • São até 500 alertas por pedido, dos mais antigos para os mais novos. Se o período tiver mais, o painel diz quantos faltam: peça de novo em alguns minutos.
  • O alerta que ainda tem tentativa automática pela frente não sai em dobro, nem se você pedir duas vezes seguidas.
  • Sai só o webhook: o e-mail do alerta não é enviado de novo.

Para conferir pelo seu sistema o que ficou sem resposta, consulte os alertas pendentes do período (status=pending com date_from e date_to).

O reenvio pelo painel vale para alertas. O evento dispute.fraud.revoke_access não tem reenvio manual.

O botão Enviar evento de teste, em Configurações › Webhook, manda à sua URL um webhook.test com os mesmos headers e a mesma assinatura das entregas reais. Ele sai uma vez, sem retentativa, e o painel mostra na hora o código que a sua URL respondeu. A tentativa fica no Histórico de entregas como qualquer outra, sem o Tentar novamente, e não conta nas falhas de entrega dos alertas. São até 5 testes por minuto.