Como integrar a Cakto ao Comizy
Configure o webhook Cakto produtor e receba cada notificação de venda Cakto diretamente no Comizy. Com a integração ativa, aprovações, reembolsos e cancelamentos são sincronizados automaticamente com o seu dashboard.
O que você vai precisar
- Conta ativa na Cakto como produtor
- Acesso ao painel do Comizy
Passo a passo para configurar o webhook
- No Comizy, clique em Cakto. Um modal será aberto com a URL do webhook gerada para você. Copie essa URL:
- Gere uma chave secreta única: acesse uuidgenerator.net, clique em Generate UUID e copie o valor gerado. Guarde-o — você vai precisar dele em dois lugares.
- No painel da Cakto, acesse Webhooks e clique em Criar novo Webhook. Preencha o formulário conforme abaixo:
- Nome: escolha um nome para identificar (ex: Comizy)
- URL: cole a URL copiada do Comizy no passo 1
- Produtos: selecione os produtos que deseja monitorar — lembre-se que você precisa ser o produtor desses produtos
- Tipo de disparo: selecione Individual (envia um evento para cada item vendido)
- Eventos: marque exatamente estes seis eventos — Compra aprovada, Compra recusada, Reembolso, Chargeback, Assinatura cancelada e Assinatura criada
- Chave secreta do Webhook: cole a chave gerada no passo 2
- Clique em Salvar para criar o webhook na Cakto.
- Volte ao modal do Comizy, cole a chave secreta gerada no passo 2 no campo Chave secreta de autenticação e clique em Salvar conexão.
O webhook Cakto começa a funcionar imediatamente após salvo. Todas as vendas aprovadas disparam uma notificação automática ao Comizy.
Testando a integração
Com o webhook salvo, realize uma venda de teste ou aguarde a próxima venda real. Em até 2 minutos a transação deve aparecer em Transações > Recentes no Comizy. Confirme que o valor, o status e o produto estão corretos para validar que a notificação foi processada com sucesso.
Dúvidas frequentes
As vendas Cakto aparecem em tempo real? Sim. Cada compra aprovada dispara imediatamente o webhook para o Comizy, que atualiza o dashboard em até 2 minutos.
O webhook funciona para assinaturas recorrentes? Sim. O Comizy recebe e registra notificações de criações e cancelamentos de assinatura da Cakto.
O que fazer se o webhook não enviar notificações? Verifique se a URL está correta e se a chave secreta no Comizy é exatamente igual à cadastrada na Cakto. Confirme também que os eventos estão todos marcados.
Posso monitorar mais de um produto? Sim. No campo Produtos do formulário da Cakto você pode selecionar quantos produtos quiser, desde que você seja o produtor de cada um.
O que acontece com vendas realizadas antes da integração? O webhook só captura eventos em tempo real. Vendas anteriores à configuração não são importadas automaticamente.