Webhooks
Cadastre uma URL HTTPS pra receber os eventos da sua conta em tempo real.
Onde ficaAppsWebhooks
Webhook é uma URL sua que a Pearfy chama quando algo acontece na conta: compra aprovada, reembolso, renovação.
Passo a passo
- Abra Apps > Webhooks
- Cadastre uma URL HTTPS pública do seu sistema
- Escolha os eventos que quer receber
- Se quiser, restrinja a um produto específico
- Salve e envie um evento de teste
Eventos disponíveis
| Evento | Quando dispara |
|---|---|
compra_aprovada | Pagamento aprovado |
compra_recusada | Pagamento não passou |
compra_reembolsada | Reembolso feito |
chargeback | Contestação aberta |
pix_gerado / boleto_gerado | Cobrança emitida |
subscription_renewed | Renovação aprovada |
subscription_late | Renovação em atraso |
subscription_canceled | Assinatura cancelada |
carrinho_abandonado | Na lista, mas ainda não dispara |
Teste e reenvio
Dá pra enviar um evento de teste e reenviar uma entrega que falhou, sem esperar a retentativa. Em pedido de assinatura, o payload traz um bloco com frequência, valor, próxima cobrança e cobranças já feitas.
AtençãoAntes de confiar no payload, valide a assinatura da entrega. Veja Validar a assinatura do webhook.
Perguntas frequentes
A URL precisa ser HTTPS?
Precisa. A entrega só vai pra endpoints HTTPS públicos.
Consigo um webhook só de um produto?
Sim. Ao cadastrar, restrinja o webhook a um produto específico.
O carrinho_abandonado já funciona?
Está na lista de eventos, mas ainda não dispara. Não construa automação dependendo dele por ora.
Este artigo foi útil?