Testing local de webhooks

Como la webhookUrl debe ser HTTPS pública (ver configuración), no podés apuntarla directo a localhost. La solución estándar es exponer tu 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 solo querés ver el payload y los headers que llegan, sin procesar nada:

Abrí https://webhook.site
Copiá la URL única que te asignan.
Pedile al admin que la configure como webhookUrl de tu API key.
Emití comprobantes de prueba y observá los webhooks llegando en tiempo real.

⚠ webhook.site solo te muestra el contenido — no responde con tu lógica ni valida la firma. Es útil para inspeccionar el formato del payload, no para probar tu integración end-to-end.