Guia técnico para configurar webhooks, processar eventos em tempo real e integrar a KlivoPay com seu sistema.
Webhooks são notificações HTTP que a KlivoPay envia para o seu servidor quando algo acontece (pagamento aprovado, estornado, etc). São mais eficientes que polling (consultar a API repetidamente) e permitem automações em tempo real.
charge.paid (pagamento aprovado), charge.refused (recusado), charge.refunded (estornado), subscription.created, subscription.cancelled, subscription.renewed. Você escolhe quais eventos quer receber.
Em Configurações > Webhooks > Novo Webhook: informe a URL HTTPS do seu endpoint, selecione os eventos e salve. A KlivoPay enviará um webhook de teste para validar que o endpoint está ativo.
O payload é JSON com os dados da transação. Sempre valide a assinatura HMAC-SHA256 no header X-KlivoPay-Signature antes de processar. Retorne HTTP 200 rapidamente e processe de forma assíncrona para evitar timeout.
Liberar acesso em plataforma de cursos (Memberkit, EAD Plataforma), enviar para CRM (ActiveCampaign, Hubspot), atualizar planilha (Google Sheets via Zapier), enviar mensagem no WhatsApp, emitir nota fiscal automaticamente.