Entregas e retentativas

O que conta como sucesso

Uma entrega é bem-sucedida quando o seu servidor responde 2xx em até 15 segundos. Qualquer outra resposta (3xx, 4xx, 5xx), erro de conexão ou tempo esgotado conta como falha e a entrega é reagendada.

Redirecionamentos

Respostas 301/302 não são seguidas e contam como falha. Cadastre a URL final.

Calendário de retentativas

São até 8 tentativas no total, com intervalos crescentes (e pequena variação aleatória de até ±20%, para evitar que muitas entregas voltem no mesmo instante):

Após a tentativa	Espera aproximada até a próxima
1	2 minutos
2	5 minutos
3	15 minutos
4	1 hora
5	3 horas
6	6 horas
7	12 horas

Ao todo isso cobre aproximadamente 22 horas de indisponibilidade do seu servidor. Esgotadas as tentativas, a entrega fica como falha e a plataforma gera um alerta para a sua equipe.

O header x-seventyone-attempt informa em qual tentativa você está.

Consultar entregas pela API

Com a permissão webhooks:read:

• GET /webhook-deliveries — lista entregas (paginada), com status, número de tentativas e a resposta que o seu servidor devolveu.
• GET /webhook-deliveries/{id} — detalhes de uma entrega.

Os cabeçalhos e o corpo de resposta do seu servidor são guardados de forma resumida (o corpo é truncado) e dados sensíveis são ocultados.

Reenviar manualmente

Com a permissão webhooks:manage:

curl -X POST https://seventyonepay.online/api/v1/webhook-deliveries/ID_DA_ENTREGA/retry \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Útil depois de corrigir um problema no seu servidor. Como a mesma entrega pode chegar de novo, mantenha o processamento idempotente.

Recuperação após uma indisponibilidade

1. Corrija o seu endpoint.
2. Liste GET /webhook-deliveries e reenvie as que falharam.
3. Para conferir o que foi pago no período, consulte GET /payments (ou GET /pix/{id}) e compare com o seu sistema.

Checklist do endpoint

• HTTPS com certificado válido.
• Verifica assinatura e timestamp.
• Responde 2xx imediatamente e processa de forma assíncrona.
• Deduplica por x-seventyone-event-id.
• Não depende da ordem dos eventos.
• Registra o x-seventyone-event-id nos logs para facilitar o suporte.