Historial de entregas y monitoreo de salud

​

Configurar tu endpoint

En el panel HG.Cash, abre Configuración: Si la URL de webhook está vacía, HG.Cash no encola entregas de webhook al cliente para movimientos que dependan de la URL predeterminada.

​

Historial de entregas en el panel

HG.Cash registra cada intento HTTP de entrega (reintentos automáticos y manuales) en los logs de entregas de webhook.

​

Dónde abrirlo

El panel lateral lista cada intento (Intento #N) con estado, fecha y detalles HTTP cuando existan. Al seleccionar un intento ves:

• Estado de la entrega (Entregado, Fallido, Pendiente, Omitido)
• URL de destino
• Resumen del error (estado, código HTTP y mensaje en fallos)
• Payload JSON completo que se envió

La lista se actualiza automáticamente cada 30 segundos mientras el panel está abierto.

​

Reintento manual

En un intento fallido (o cualquier otro), usá Reintentar entrega para encolar una nueva ejecución con el mismo payload almacenado. Tu endpoint debe estar accesible y el webhook debe estar habilitado en Configuración. Los reintentos manuales no modifican filas anteriores; agregan una nueva ejecución en la cola.

​

Estados de entrega

​

Reintentos automáticos

Las entregas fallidas se reintentan según la política en Recepción de webhooks (hasta 4 intentos, backoff exponencial, 30 s máx. por intento). Cada reintento genera una fila nueva en el historial.

​

Monitoreo de salud y deshabilitación automática

Un trabajo programado corre diariamente y analiza entregas recientes por usuario con URL de webhook configurada.

​

Email de rendimiento degradado

Si al menos una entrega falló en la muestra pero la tasa de fallo es menor al 100%, HG.Cash envía un email de advertencia con la tasa de fallos y te pide revisar tu servidor y el historial en el panel.

​

Deshabilitación automática y email

Si el 100% de los intentos muestreados en la ventana fallaron:

1. HG.Cash marca tu webhook como deshabilitado (sin más POST hasta que lo habilites de nuevo).
2. HG.Cash envía un email de webhook deshabilitado (una vez por ciclo de deshabilitación).
3. Los nuevos intentos se guardan como Omitido hasta que corrijas el endpoint y vuelvas a habilitar.

​

Volver a habilitar

Con el webhook deshabilitado, Configuración muestra un aviso con fallos recientes y el botón Volver a habilitar webhook. Tras corregir tu endpoint, hacé clic para reanudar las notificaciones.

​

Guías relacionadas

• Recepción de webhooks — Formas de payload, verificación HMAC y tiempos de reintento.
• Referencia API → Webhooks — Esquemas OpenAPI y ejemplos por tipo de evento.