Webhooks: receba os eventos das suas vendas
Atualizado em 16/10/2026
Os webhooks enviam os eventos de pagamento para um endereço seu, em tempo real.
Como configurar
- Vá em Integrações e, no card Webhooks, clique em Adicionar.
- Preencha a URL do endpoint (precisa ser https) e escolha os Eventos.
- Clique em Salvar endpoint.
- Use o envio de teste para conferir.
Você pode ter até 10 endpoints. O dono da conta e os administradores podem configurar.
Eventos
| Evento | Quando |
|---|---|
| order.paid | Pedido pago |
| order.pending | Aguardando pagamento |
| order.abandoned | Checkout abandonado |
| order.refunded | Reembolsado |
| order.partially_refunded | Reembolso parcial |
| order.chargeback | Chargeback |
| order.refused | Pagamento recusado |
| upsell.paid | Upsell pago |
| subscription.activated / renewed / cancelled / overdue | Eventos de assinatura |
Segurança
Cada endpoint tem um Signing secret (whsec_…), que você vê em Revelar. Cada envio traz o cabeçalho X-Frendz-Signature com o HMAC SHA-256 do corpo, além de X-Frendz-Event e X-Frendz-Delivery. Confira a assinatura antes de processar.
Novas tentativas
O envio conta como entregue quando o seu endereço responde 2xx em até 10 segundos. Se falhar, a Frendz tenta de novo até 6 vezes, em intervalos crescentes (de 1 minuto a 12 horas). O histórico de envios fica no painel, com opção de reenviar.
Depois de 20 entregas seguidas sem sucesso, o endpoint é desativado e você recebe um e-mail.