Como integrar a Kiwify ao Vestige

Este guia mostra como criar o webhook na Kiwify, selecionar produtos e eventos e informar o token no Vestige.

1. Obtenha a URL no Vestige

1. Acesse Configurações → Integrações.
2. Abra Kiwify.
3. Copie a URL do webhook exibida pela integração.

Use a URL gerada pela sua conta do Vestige. Não copie a URL exibida em prints antigos.

2. Abra os webhooks na Kiwify

1. Acesse o painel da Kiwify.
2. No menu lateral, abra Apps.
3. Entre em Webhook.
4. Clique em Criar Webhook.

3. Configure o webhook

Preencha os campos da configuração:

• Nome: use um nome que identifique a integração, como Vestige;
• URL: cole a URL copiada no Vestige;
• Produto: selecione Todos ou os produtos que devem enviar transações;
• Eventos: selecione os eventos disponíveis para a operação.

Salve a configuração realizada na Kiwify.

O artigo de referência orientava selecionar todos os produtos e todos os eventos. No Vestige, o processamento ainda depende de o evento representar uma transação aprovada ou um reembolso; criar pedido, pagamento pendente e outros estados não devem ser tratados automaticamente como venda aprovada.

4. Copie o token

Ao criar o webhook, copie o Token apresentado pela Kiwify. Esse token é usado para autenticar a comunicação da integração.

1. Volte à integração Kiwify no Vestige.
2. Cole o valor no campo Token.
3. Salve as alterações.

Não publique o token nem o compartilhe em screenshots ou chamados.

5. Teste a integração

Depois de salvar, siga Como testar uma integração de vendas. Vendas realizadas por boleto só devem aparecer depois da compensação do pagamento, que o material de referência indica como podendo levar até 3 dias úteis.

Se a venda não aparecer, confira URL, produto, eventos e token em O webhook está configurado, mas as vendas não aparecem.