Webhooks
Recibe eventos en tiempo real en tu propio sistema en vez de consultar la API periódicamente.
🟡 Próximamente.
En vez de que tu integración pregunte "¿ya se pagó esta factura?" cada cierto tiempo,
Valwisp puede avisarte apenas ocurra. Configura una URL desde Ajustes → API →
Webhooks y Valwisp le hace POST a esa URL cada vez que ocurre un evento que
suscribiste.
Eventos disponibles
| Evento | Cuándo se dispara |
|---|---|
cliente.creado | Se registra un cliente nuevo |
cliente.activado | Un cliente pasa de suspendido a activo |
cliente.suspendido | Un cliente se suspende (manual o por mora) |
factura.creada | Se genera una factura nueva |
factura.pagada | Se registra un pago que cubre una factura |
factura.anulada | Se anula una factura |
ticket.creado | Se crea un ticket de soporte |
ticket.cerrado | Se cierra un ticket |
instalacion.completada | Una orden de instalación se marca como completada |
Formato del payload
{
"evento": "factura.pagada",
"data": {
"idFactura": "inv_2161",
"clienteId": "cli_9f8e7d",
"monto": 1500.00,
"fecha": "2026-08-05"
},
"timestamp": "2026-08-05T14:00:00.000Z"
}Verificar la firma
Cada petición incluye un header X-Valwisp-Signature — un HMAC-SHA256 del cuerpo crudo
de la petición, firmado con el secreto que Valwisp te muestra una sola vez al crear el
webhook. Verifícalo antes de confiar en el payload:
X-Valwisp-Signature: sha256=5d41402abc4b2a76b9719d911017c592...Reintentos
Si tu endpoint no responde 2xx, Valwisp reintenta con backoff exponencial (hasta 5
intentos en 24 horas). Puedes ver el historial de entregas y reenviar manualmente desde
Ajustes → API → Webhooks.