Artigos sobre: Tutorial

Como configurar um Webhook

Webhook é um recurso que permite que nossa plataforma envie notificações automáticas para outros sistemas sempre que um evento acontece (como uma venda aprovada ou um reembolso). Assim, a comunicação é imediata e não precisa de consultas manuais. Os webhooks podem ser usados para automatizar processos. Por exemplo:


  • Receber confirmação automática de uma venda ou pagamento.
  • Atualizar estoques ou sistemas internos em tempo real.
  • Enviar notificações para o cliente ou para o time da empresa.
  • Integrar nossa plataforma com outros sistemas sem precisar de ações manuais.

 

 

1. Para visualizar seus webhooks clique em "Webhooks Enviados" na barra lateral


2. Já nessa tela, você poderá visualizar todos os seus eventos de webhooks


3. Acessando a opção de "+" no canto direito ao webhook desejado


4. Você poderá acessar o código de envio e retorno de seu webhook.


5. Já para criar um webhook acesse a janela de "Apps" na barra lateral


6. E depois "Webhooks"


 

7. Já dentro da janela de webhook, você poderá visualizar os webhook já criados (caso haja algum) procure pela opção de "Novo Webhook"

8. Após clicar para criar novo webhook surgirá um painel para a configuração do webhook, tendo as opções de:

    • Nome - Para melhor identificação do webhook
    • URL do webhook -

I Opções para teste de webhook

    • Token - Esse Token será enviado no Header da requisição no campo Api-Token para validação da autenticidade do envio.
    • produto - Produto que será selecionado pra essa tentativa
    • Quantidade de tentativas -
    • Enviar para os orderbumps - Quando essa opção estiver habilitada será feito o envio por produto. Ex.: Comprando o produto e mais um orderbump, será enviado os dois eventos caso tenha configurações para o mesmo.
    • Enviar para vendas de afiliados - Ao habilitar essa opção as compras com o link dos afiliados serão dispados para esse webhook.

I Opções para Eventos

 

I Opções para eventos unicos

    • Boleto gerado - Evento gerado quando um compra é aprovada com meio de pagamento do tipo 'Boleto'
    • Pix gerado - Evento gerado quando um compra é aprovada com meio de pagamento do tipo 'PIX'"

I Opções de Compras

    • Compra recusadas - Compra com cartão de crédito/débito recusada pelo 'gateway de pagamento', pelo próprio cartão ou pelo banco.
    • Compra aprovada - Compra aprovada pelo 'gateway de pagamento'
    • Compra expirada - Compras que iniciaram por PIX ou boleto e não foram pagos.
    • Aguardado pagamento - Para compras não imediatas que precisam de uma ação de pagamento do usuário.
    • Estorno (ChargeBack) - O usuário faz uma solicitação de reembolso da compra pelo emissor do cartão.
    • Solicitação reembolso - Solicitação de reembolso pelo usuário.
    • Reembolso - Reembolso realizado para o usuário.

I Opções de Assinaturas

    • Assinatura ativa - Dispara automaticamente o webhook ao atingir o período de renovação de uma assinatura ativa
    • Assinaturas atrasada - Dispara automaticamente o webhook ao falhar a primeira tentativa de uma renovação de uma assinatura ativa"
    • Assinatura Cancelada - Ao cancelar uma assinatura é disparado o webhook
    • Assinatura Bloqueada - Dispara automaticamente o webhook ao atingir o final das tentativas de cobranças sem sucesso
    • Assinatura Concluída - Dispara automaticamente o webhook ao concluir todas as cobranças configuradas da assinatura

I Outros

    • Compras abandonadas - Usuários que chegaram no carrinho e não finalizaram a compra.
    • Afiliação - Usuários que se afiliaram a um determinado produto.


9. Para testar o Webhook já configurado, faça o seguinte, entre no site Webhook-testWebhook Tester | Simple & Free Webhook Testing Tool Dentro do site de teste, clique no botão vermelho ao lado do link para copia-lo


10. Cole esse link na barra de URL do webhook


 

11. Após colar, clique em "Testar Webhook



12. Surgirá outro painel mostrando as configurações que serão testadas, clique novamente em "Testar webhook"


13. Após clicar, carregará por alguns segundos a tela de teste, e surgirá a confirmação caso todos os eventos tenham dado certo


14. Ao voltar no site, você também poderá visualizar os eventos que foram recebidos pelo webhook


 

15. Após realizar o teste e confirmar que deu tudo certo, apenas clique em "salvar" no painel de webhook


16. Após realizar alguma venda, O webhook que criou para produto especifico ou para todos, já começará a ser registrado em "Webhook enviados"


Atualizado em: 04/09/2025

Este artigo foi útil?

Compartilhe seu feedback

Cancelar

Obrigado!