Notificações de eventos

Na ativação, renovação ou revogação, Licentivo pode notificar seu servidor para sincronizar pedidos, clientes e suporte.

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.

Adicionar endereço de notificação

Em Notificações de licença, adicione URL HTTPS e eventos. Ao salvar, o segredo de assinatura aparece uma vez; guarde no servidor receptor. Produção não permite destinos locais ou privados.

Verifique a assinatura após receber

Leia X-Licentivo-Timestamp, X-Licentivo-Event e corpo bruto. Junte timestamp + '.' + ID do evento + '.' + corpo, calcule HMAC-SHA256 com o segredo, prefixe sha256= e compare com X-Licentivo-Signature em tempo constante. Rejeite diferença maior que 5 minutos.

Deduplicate pelo ID. Confira assinatura, coloque na transação ou fila e retorne 2xx após persistir. Duplicatas recebem 2xx sem repetir ações de pedido.

O que ocorre em caso de falha?

Até 8 tentativas automáticas, com intervalos crescentes. O console mostra HTTP, horário e erros, e permite reenvio manual. Evento e operação compartilham transação; envio continua após reiniciar.

Eventos: criação, alteração, renovação, revogação, ativação, liberação, consumo, próximo vencimento, expiração e manutenção. Notificação só inclui prefixo, nunca a chave completa.