Skip to main content

Configure your endpoint

In the HG.Cash dashboard, open Settings: If Webhook URL is empty, HG.Cash does not enqueue customer webhook deliveries for movements that rely on the default URL.

Delivery history in the dashboard

HG.Cash records every HTTP delivery attempt (including automatic retries and manual retries) in Webhook delivery logs.

Where to open it

The side sheet lists each attempt (Intento #N) with status, timestamp, and HTTP details when available. Select an attempt to see:
  • Delivery status (Entregado, Fallido, Pendiente, Omitido)
  • Target URL
  • Error summary (status, HTTP code, and message for failures)
  • Full JSON payload that was posted
The list refreshes automatically every 30 seconds while the sheet is open.

Manual retry

On a failed (or any) attempt, use Reintentar entrega to enqueue a new delivery run with the same stored payload. Your endpoint must still be reachable and your webhook must be enabled in Settings. Manual retries do not rewrite past attempt rows; they add a new delivery run in the queue.

Delivery statuses

Automatic retries

Failed deliveries are retried by HG.Cash with the policy documented in Receiving webhooks (up to 4 attempts, exponential backoff, 30 s max per attempt). Each retry creates a new row in the delivery history.

Health monitoring and auto-disable

A daily job runs and analyzes recent delivery outcomes per user with a configured webhook URL.

Degraded performance email

If at least one delivery failed in the sample but the failure rate is below 100%, HG.Cash sends a warning email describing the failure rate and asking you to check your server and the delivery history in the dashboard.

Auto-disable and disabled email

If 100% of sampled attempts in the window failed:
  1. HG.Cash sets your webhook to disabled (no further outbound POSTs until you re-enable).
  2. HG.Cash sends a webhook disabled email (once per disable cycle).
  3. New delivery attempts are stored as Omitido until you fix the endpoint and re-enable.

Re-enable after auto-disable

When your webhook is disabled, Settings shows a banner with recent failed attempts and a Volver a habilitar webhook button. After you fix your endpoint, click it to resume notifications.
Email alerts require email notifications enabled.
  • Receiving webhooks — Payload shapes, HMAC verification, and retry timing.
  • API reference → Webhooks — OpenAPI schemas and example bodies for each event type.