Pular para o conteúdo principal

​
Configurar seu endpoint

No painel HG.Cash, abra Configurações: Se a URL do webhook estiver vazia, a HG.Cash não enfileira entregas de webhook ao cliente para movimentações que dependam da URL padrão.

​
Histórico de entregas no painel

A HG.Cash registra cada tentativa HTTP de entrega (retentativas automáticas e manuais) nos logs de entregas de webhook.

​
Onde abrir

O painel lateral lista cada tentativa (Intento #N) com status, data e detalhes HTTP quando disponíveis. Ao selecionar uma tentativa você vê:
  • Status da entrega (Entregado, Fallido, Pendiente, Omitido)
  • URL de destino
  • Resumo do erro (status, código HTTP e mensagem em falhas)
  • Payload JSON completo enviado
A lista atualiza automaticamente a cada 30 segundos com o painel aberto.

​
Retentativa manual

Em uma tentativa com falha (ou qualquer outra), use Reintentar entrega para enfileirar uma nova execução com o mesmo payload armazenado. Seu endpoint precisa estar acessível e o webhook habilitado em Configurações. Retentativas manuais não alteram linhas anteriores; adicionam uma nova execução na fila.

​
Status de entrega

​
Retentativas automáticas

Entregas com falha seguem a política em Recebimento de webhooks (até 4 tentativas, backoff exponencial, 30 s máx. por tentativa). Cada retentativa cria uma nova linha no histórico.

​
Monitoramento de saúde e desativação automática

Um job agendado roda diariamente e analisa entregas recentes por usuário com URL de webhook configurada.

​
E-mail de desempenho degradado

Se pelo menos uma entrega falhou na amostra, mas a taxa de falha é menor que 100%, a HG.Cash envia um e-mail de aviso com a taxa de falhas e pede para revisar seu servidor e o histórico no painel.

​
Desativação automática e e-mail

Se 100% das tentativas na amostra da janela falharam:
  1. A HG.Cash marca seu webhook como desabilitado (sem novos POST até reabilitar).
  2. A HG.Cash envia um e-mail de webhook desabilitado (uma vez por ciclo de desativação).
  3. Novas tentativas são gravadas como Omitido até corrigir o endpoint e reabilitar.

​
Reabilitar

Com o webhook desabilitado, Configurações exibe um aviso com falhas recentes e o botão Volver a habilitar webhook. Após corrigir o endpoint, clique para retomar as notificações.
Alertas por e-mail exigem alertas no email ativadas.

​
Guias relacionados

  • Recebimento de webhooks — Formatos de payload, verificação HMAC e tempos de retentativa.
  • Referência da API → Webhooks — Schemas OpenAPI e exemplos por tipo de evento.