Testing local de webhooks

Dado que la webhookUrl debe ser HTTPS pública (ver configuración), no es posible apuntarla directamente a localhost. La solución estándar consiste en exponer el servidor local mediante un túnel.

Con ngrok


# 1. Instala ngrok
brew install ngrok  # macOS
 
# 2. Expón tu servidor local
ngrok http 3000
 
# Salida:
# Forwarding  https://abcd1234.ngrok.io -> http://localhost:3000
 
# 3. Pide al admin actualizar el webhookUrl de tu key:
#    https://abcd1234.ngrok.io/webhooks/lxs
 
# 4. Emite una factura de prueba y observa los logs locales

Con Cloudflare Tunnel

Alternativa gratuita sin cuenta:


cloudflared tunnel --url http://localhost:3000
 
# Genera un dominio temporal *.trycloudflare.com

Con webhook.site (solo para inspeccionar)

Cuando únicamente se requiere inspeccionar el payload y los headers entrantes, sin procesarlos:

Acceder a https://webhook.site
Copiar la URL única asignada.
Solicitar al administrador que la configure como webhookUrl de la API key.
Emitir comprobantes de prueba y observar la llegada de los webhooks en tiempo real.

Importante: webhook.site únicamente muestra el contenido: no ejecuta la lógica del receptor ni valida la firma. Resulta útil para inspeccionar el formato del payload, no para probar la integración end-to-end.