Notifiche di eventi

Quando una licenza viene attivata, rinnovata o revocata, Licentivo può avvisare il tuo server per sincronizzare ordini, clienti e sistemi di supporto.

To manage license expiration and renewal notifications, subscribe to expiring, expired and renewed events. Your website can verify the latest state and send customer emails. Webhooks report state changes; they do not automatically send reminders on a merchant's behalf.

Aggiungi endpoint di notifica

Apri le notifiche degli eventi di licenza, aggiungi HTTPS URL del tuo server e seleziona gli eventi. Il salvataggio mostra il segreto della firma una volta; memorizzarlo sul server ricevente. La produzione non consente destinazioni di rete locali o private.

Verificare la firma dopo il ricevimento

Leggi X-Licentivo-Timestamp, X-Licentivo-Event e il corpo della richiesta grezza. Iscriviti timestamp + '.' + ID evento + "." + corpo, calcola HMAC-SHA256 con il segreto della firma, anteponi sha256= e confronta con X-Licentivo-Signature in tempo costante. Rifiuta i timestamp tra più di 5 minuti da adesso.

Deduplica per ID evento. Verifica la firma, inserisci l'evento nella transazione o nella coda e restituisci 2xx dopo l'archiviazione duratura. Per i duplicati, restituisci 2xx senza ripetere le azioni dell'ordine.

Cosa succede in caso di fallimento?

La consegna viene tentata automaticamente fino a 8 volte con ritardi crescenti. La console mostra lo stato HTTP, l'ora del tentativo e gli errori e consente la riconsegna manuale. Gli eventi e le operazioni di licenza condividono una transazione di database; la consegna riprende dopo un riavvio.

Gli eventi riguardano la creazione, gli aggiornamenti, il rinnovo, la revoca, l'attivazione, il rilascio, l'utilizzo delle funzionalità, la scadenza imminente, la scadenza e le modifiche di manutenzione. Le notifiche includono solo il prefisso della licenza, mai la chiave completa.