Retries e logs
Política de retentativa
Seção intitulada “Política de retentativa”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.
- Na hora 1ª tentativa, assim que o evento é enfileirado
- +5 min 2ª tentativa, 5 minutos depois da falha anterior (5 minutos desde o início)
- +15 min 3ª tentativa (20 minutos desde o início)
- +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.
Timeout
Seção intitulada “Timeout”Cada tentativa tem timeout de 30 segundos. Se sua aplicação não responder nesse prazo, a tentativa é considerada falha.
O que conta como sucesso
Seção intitulada “O que conta como sucesso”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.
Redirecionamento
Seção intitulada “Redirecionamento”Cadastre a URL final. A Rapid trata redirecionamento assim:
| Resposta da sua URL | O que acontece |
|---|---|
301, 302, 303 | Falha. 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ínio | Seguido, com o POST, o corpo e os headers intactos. Até 3 redirecionamentos seguidos. |
307, 308 para outro domínio | Falha. 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.
Endereço que não é público
Seção intitulada “Endereço que não é público”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.
Empresas bloqueadas
Seção intitulada “Empresas bloqueadas”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).
Logs de entrega
Seção intitulada “Logs de entrega”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.
Reenvio manual
Seção intitulada “Reenvio manual”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.
Reenviar as falhas de um período
Seção intitulada “Reenviar as falhas de um período”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.
Evento de teste
Seção intitulada “Evento de teste”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.