Receber com segurança

Entrega e reenvio

O que acontece quando o seu servidor não responde, quando o mesmo aviso chega duas vezes e como reenviar um aviso pelo painel.

O que conta como entregue

Um aviso só está entregue se o seu servidor responder com status 2xx em até 5 segundos. Qualquer outra coisa (4xx, 5xx, demora, erro de conexão, certificado inválido) conta como falha e o aviso entra na fila de novas tentativas. Lemos no máximo 64 KB da resposta e guardamos só o começo dela, para você ver no painel.

Novas tentativas

São até 8 tentativas no total: a primeira e mais 7. Entre uma e outra a espera cresce:

TentativaQuando acontece
1ªLogo depois do evento
2ªcerca de 1 minuto depois da 1ª
3ªcerca de 5 minutos depois da 2ª
4ªcerca de 15 minutos depois da 3ª
5ªcerca de 1 hora depois da 4ª
6ªcerca de 3 horas depois da 5ª
7ªcerca de 6 horas depois da 6ª
8ª (última)cerca de 12 horas depois da 7ª

Os horários são aproximados (a fila roda em ciclos curtos). Depois da 8ª falha o envio fica como falhou e não tenta mais sozinho.

Com todas as tentativas, o seu servidor tem cerca de 22 horas para voltar. Passou disso, use o reenvio do painel e a conciliação para recuperar o que perdeu.

Repetição e ordem

  • O mesmo aviso pode chegar mais de uma vez (a sua resposta se perdeu no caminho, por exemplo). O id do evento é sempre o mesmo: guarde os já tratados.
  • Os avisos podem chegar fora de ordem. Um venda.expirada que falhou e foi reenviado pode chegar depois do venda.aprovada da mesma cobrança. Use a sequencia: ignore o evento com sequência menor que a última que você tratou daquele recurso.
  • O conteúdo de dados é o do momento do evento, também nas novas tentativas. Para saber como a cobrança está agora, consulte GET /charges/{id}.
idtexto

Mesmo valor em todas as tentativas do mesmo evento: é a chave da sua idempotência.

sequenciainteiro

Ordem em que os eventos aconteceram na conta. Evento mais novo tem número maior.

X-Grinny-Eventcabeçalho

O tipo do evento, para você roteirizar antes de ler o corpo.

X-Grinny-Signaturecabeçalho

Horário e assinatura. A assinatura é nova a cada tentativa (muda o t): confira sempre a que veio no pedido.

Reenviar pelo painel

  • Em Integrações › Webhooks você vê os envios, o código que o seu servidor respondeu e o começo da resposta.
  • O botão de reenvio põe o aviso de volta na fila, com a contagem de tentativas zerada.
  • Existe um limite de reenvios seguidos por conta (para ninguém derrubar o próprio servidor por engano).
  • Webhook pausado não recebe nada: os avisos esperam e saem quando você ativa de novo.
  • Webhook excluído para na hora e as entregas pendentes dele são descartadas.

Por quanto tempo guardamos

O conteúdo dos avisos enviados (que inclui o nome e o e-mail do comprador) fica guardado por tempo limitado e depois é apagado. O histórico de que o envio aconteceu continua. Por isso, não conte com o painel como arquivo: grave o que importa no seu sistema.