Conectar sua plataforma de vendas
Onde colar a URL do webhook, quais eventos marcar em cada plataforma e como saber que deu certo.
Atualizado em
Antes de começar
A conexão fica em Integrações, no menu lateral do app. A tela separa as plataformas em Conectadas, Disponíveis para conectar e Em breve.
Conectada, a plataforma avisa a emite ai de cada venda pelo webhook. Venda aprovada emite a nota; reembolso, chargeback ou cancelamento desfaz a nota.
Antes da primeira venda, deixe o perfil de emissão da empresa preenchido e o produto aprovado. O passo a passo está em Antes da primeira venda.
Passo a passo
Em Integrações, clique em Conectar no card da sua plataforma.
Copie a URL do webhook e cole no painel da plataforma.
O lugar exato de cada plataforma está na seção dela, logo abaixo.Na plataforma, marque só os eventos listados na seção dela.
Eventos de pré-venda, como boleto gerado ou carrinho abandonado, não geram nota.Copie o token que a plataforma mostrar, cole em Token de autenticação e clique em Conectar.
Assiny e Greenn não geram token: a seção de cada uma explica o que colar. Se um dia trocar o token na plataforma, use Atualizar token no mesmo painel.Depois da próxima venda, abra a aba Eventos recentes do painel.
Ali aparece cada evento que a plataforma mandou. A aba Configuração guarda a URL e o token.
Escolha a sua plataforma
Cada plataforma chama os eventos de um jeito. Escolha a sua para ver onde fica o webhook e o que marcar.
Hubla
Onde fica
Hubla depois Configurações depois Integrações depois Webhooks
Eventos para marcar
Pagamento da fatura realizado- O que faz
- venda confirmada, emite a nota
Fatura reembolsada- O que faz
- reembolso efetivado, desfaz a nota
Marque só esses dois, com esses nomes exatos. Não marque "Solicitação de reembolso aceita". Esse é só o pedido, não o reembolso efetivado. Em Produtos, selecione Todos os produtos, e em Ofertas, Todas as ofertas: assim a regra pega o que existe hoje e o que for criado depois. Não deixe em branco nem escolha um produto só. Onde fica o token: a Hubla mostra o token (64 caracteres) logo depois de clicar em Criar regra.
Kiwify
Onde fica
Kiwify depois Apps depois Webhooks depois Criar Webhook
Eventos para marcar
Compra aprovada- O que faz
- venda confirmada, emite a nota
Assinatura renovada- O que faz
- venda confirmada, emite a nota
Reembolso- O que faz
- reembolso efetivado, desfaz a nota
Chargeback- O que faz
- chargeback, desfaz a nota
Marque só esses quatro, com esses nomes exatos. Não marque "Compra recusada". O pagamento não passou, não tem venda. Não marque "Pix gerado". O Pix ainda não foi pago. Não marque "Boleto gerado". O boleto ainda não foi pago. Não marque "Assinatura cancelada". Cancelar a assinatura não desfaz cobrança já paga. Não marque "Assinatura atrasada". A cobrança não foi paga, não tem venda. Onde fica o token: a Kiwify mostra o token na hora de criar ou editar o webhook.
Hotmart
Onde fica
Hotmart depois Ferramentas depois Ver todas depois Webhook (API e notificações) depois Cadastrar Webhook
Eventos para marcar
Compra aprovada- O que faz
- venda confirmada, emite a nota
Compra reembolsada- O que faz
- reembolso efetivado, desfaz a nota
Chargeback- O que faz
- chargeback, desfaz a nota
Marque só esses três, com esses nomes exatos. Não marque "Pedido de reembolso". É só o pedido, o reembolso ainda pode ser negado. Não marque "Compra completa". É a mesma venda depois da garantia; ela já chega por Compra aprovada. Onde fica o token: o hottok (Hottok de verificação) fica na área de Webhook da Hotmart.
Eduzz
Onde fica
Eduzz depois https://integrations.eduzz.com/webhook/new (área de Webhooks do painel)
Eventos para marcar
Paga- O que faz
- venda confirmada, emite a nota
Reembolsada- O que faz
- reembolso efetivado, desfaz a nota
Cancelada- O que faz
- cancelamento, desfaz a nota
Marque só esses três, com esses nomes exatos. Não marque "Aguardando reembolso". O reembolso ainda não foi feito. Os eventos ficam no grupo MyEduzz: Fatura. Onde fica o token: em Segurança, no painel de webhooks da Eduzz (Chave de acesso).
Ticto
Onde fica
Ticto depois Tictools depois Webhooks
Eventos para marcar
Venda Realizada- O que faz
- venda confirmada, emite a nota
Reembolso- O que faz
- reembolso efetivado, desfaz a nota
Chargeback- O que faz
- chargeback, desfaz a nota
Marque só esses três, com esses nomes exatos. Não marque "Encerrado". É a operação do boleto finalizada, não a venda paga. Onde fica o token: o Token fica no próprio formulário do webhook da Ticto.
Kirvano
Onde fica
Kirvano depois Integrações depois Webhooks depois Criar Webhook
Eventos para marcar
- Compra aprovada
- O que faz
- venda confirmada, emite a nota
- Assinatura renovada
- O que faz
- venda confirmada, emite a nota
- Reembolso
- O que faz
- reembolso efetivado, desfaz a nota
- Chargeback
- O que faz
- chargeback, desfaz a nota
Payt
Onde fica
Payt depois Ferramentas depois Postbacks depois Cadastrar
Eventos para marcar
Finalizada/Aprovada- O que faz
- venda confirmada, emite a nota
Cancelada - Reembolsada- O que faz
- reembolso efetivado, desfaz a nota
Cancelada - Chargeback- O que faz
- chargeback, desfaz a nota
Marque só esses três, com esses nomes exatos. Não marque "Solicitação de Reembolso". É só o pedido, não o reembolso concluído. Não marque "Cancelada". É compra não autorizada no cartão, não é reembolso. Não marque "Faturada". Dispara quando a Payt gera nota da venda; a venda já chega por Finalizada/Aprovada. Onde fica o token: a Chave Única aparece na tela de Postbacks da Payt.
Assiny
Onde fica
Assiny depois Integrações depois Webhooks depois Novo Webhook
Eventos para marcar
- Pedido pago
- O que faz
- venda confirmada, emite a nota
- Reembolso realizado
- O que faz
- reembolso efetivado, desfaz a nota
Digital Manager Guru
Onde fica
Digital Manager Guru depois Configurações depois Webhooks depois Vendas depois Adicionar Webhook
Eventos para marcar
Aprovada- O que faz
- venda confirmada, emite a nota
Reembolsada- O que faz
- reembolso efetivado, desfaz a nota
Reclamada- O que faz
- chargeback, desfaz a nota
Marque só esses três, com esses nomes exatos. Não marque "Reembolso Sol.". É só o pedido de reembolso, não o reembolso feito. Não marque "Cancelada". Na Guru é pagamento que não foi concluído, não venda cancelada. Não marque "Completo". É a mesma venda depois da garantia; ela já chega por Aprovada. No campo Status dá para escolher mais de um. Onde fica o token: o Token API fica em Minha Conta, aba Detalhe, seção API.
Greenn
Onde fica
Greenn depois Produtos depois Meus Produtos depois Editar Produto depois Conteúdos depois Adicionar Conteúdo depois Sistema Externo depois Webhook
Eventos para marcar
Venda Paga- O que faz
- venda confirmada, emite a nota
Venda Reembolsada- O que faz
- reembolso efetivado, desfaz a nota
Chargeback realizado- O que faz
- chargeback, desfaz a nota
Marque só esses três, com esses nomes exatos. Não marque "Venda aguardando pagamento". É boleto ou Pix gerado e ainda não pago; a venda chega por Venda Paga. Na Greenn o webhook é por produto: configure em cada produto que vende. Produto de assinatura só mostra os eventos de Assinatura: aí marca Assinatura paga. Onde fica o token: não tem token da plataforma: a chave vai no fim da URL do webhook (?key=...), gerada pela emite ai ao conectar; a URL completa aparece em Integrações, no card da plataforma. A Greenn não gera token: a URL do webhook leva uma chave que a emite ai gera ao conectar. Cole a URL completa, com a chave no fim.
Stripe
Onde fica
Stripe depois Workbench depois Webhooks depois Criar um destino de evento
Eventos para marcar
checkout.session.completed- O que faz
- venda confirmada, emite a nota
invoice.paid- O que faz
- venda confirmada, emite a nota
checkout.session.async_payment_succeeded- O que faz
- venda confirmada, emite a nota
charge.succeeded- O que faz
- venda confirmada, emite a nota
charge.refunded- O que faz
- reembolso efetivado, desfaz a nota
charge.dispute.closed- O que faz
- chargeback, desfaz a nota
Marque só esses 6, com esses nomes exatos. Não marque "refund.created". O mesmo reembolso já chega por charge.refunded. Não marque "charge.dispute.created". É só a abertura da disputa; a nota só é cancelada quando o chargeback é perdido (charge.dispute.closed). Não marque "payment_intent.succeeded". A mesma cobrança já chega por charge.succeeded, checkout.session.completed ou invoice.paid. Não marque "customer.subscription.deleted". Cancelar a assinatura não desfaz nota de cobrança já paga. Na Stripe o nome do evento na tela é o próprio código técnico. Não marque todos os eventos. Reembolso parcial não cancela a nota; só o reembolso total. Onde fica o token: o segredo de assinatura (começa com whsec_) aparece em Revelar segredo, na tela do destino.
Asaas
A conexão com a Asaas é feita pelo nosso time, porque usa a chave de API da sua conta e ainda não tem tela no app. Fale com o time pelo WhatsApp, no fim desta página.
Pausar a integração
Em Integrações, abra a plataforma e clique em Pausar. A emite ai confirma antes, porque a pausa tem um efeito: as vendas que a plataforma mandar nesse período não viram nota e não ficam guardadas. A plataforma não reenvia essas vendas quando você ativa de novo.
Pause quando quiser que nenhuma venda daquela plataforma vire nota, por exemplo ao trocar de CNPJ ou encerrar um produto. Se o problema é uma nota saindo errada, corrija o produto ou o perfil de emissão e deixe a integração ligada: a venda fica registrada.
Para voltar a emitir, clique em Ativar no painel da integração.
Como saber que deu certo
O card da plataforma em Integrações mostra um selo com o estado da conexão.
- Aguardando a primeira venda
- O que fazer
- A conexão está feita e nenhuma venda chegou ainda. Espere a próxima; se ela acontecer e o selo não mudar, confira a URL e os eventos marcados na plataforma.
- Ao vivo
- O que fazer
- As vendas estão chegando e as notas estão saindo. Nada a fazer.
- Vendas sem nota
- O que fazer
- Chegou venda que ainda não virou nota. Abra o card: o painel diz quantas estão sem nota e o que falta para sair.
- Recebendo vendas
- O que fazer
- As vendas estão chegando, mas não deu para conferir agora se todas viraram nota. Abra o card para ver.
- Atenção
- O que fazer
- A integração está pausada ou parte dos eventos das últimas 24 horas falhou ao processar. O card mostra a Taxa de sucesso logo abaixo do selo; no painel, a aba Eventos recentes mostra cada evento. Veja Pausar a integração.