Documentation Index
Fetch the complete documentation index at: https://docs.hg.cash/llms.txt
Use this file to discover all available pages before exploring further.
Configurar tu endpoint
En el panel HG.Cash, abre Configuración:
| Ajuste | Propósito |
|---|
| URL de webhook | Destino POST predeterminado para notificaciones de transacciones del libro y solicitudes de transacción cuando no indiques un webhookUrl por operación. |
| Secreto de firma del webhook | Opcional. Si está configurado, cada notificación saliente incluye X-HG-Webhook-Signature. Generá o rotá el secreto en Configuración; el valor en claro se muestra una vez tras regenerar—guardalo de forma segura. |
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
| Pantalla | Cómo |
|---|
| Transacciones | Abrí el detalle de una transacción → clic en Webhooks. |
| Transferencias | Seleccioná una solicitud de transacción → clic en Webhooks. |
- 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
| Estado | Significado |
|---|
| Pendiente | Intento registrado; llamada HTTP en curso o aún no finalizada en el log. |
| Entregado | Tu endpoint respondió 2xx. |
| Fallido | HTTP distinto de 2xx, error de red o timeout. Puede reintentarse automáticamente hasta agotar intentos. |
| Omitido | HG.Cash no llamó tu URL porque el webhook del usuario estaba deshabilitado (ver abajo). |
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.
| Parámetro | Valor |
|---|
| Ventana de análisis | 24 horas |
| Tamaño de muestra | Hasta los 50 intentos fallidos o entregados más recientes |
| Mínimo de muestras antes de actuar | 5 |
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:
- HG.Cash marca tu webhook como deshabilitado (sin más
POST hasta que lo habilites de nuevo).
- HG.Cash envía un email de webhook deshabilitado (una vez por ciclo de deshabilitación).
- 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.
Las alertas por email requieren notificaciones de email activas.
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.
