Integrações que funcionam hoje
Hotmart, Kiwify, Cakto, Hubla, Stripe e Meta Ads: o passo a passo de cada uma.
Estas integrações funcionam hoje. Todas estão em beta: foram testadas com eventos simulados, ainda sem homologação com conta real, e o estado de cada uma aparece em Configurações.
Hotmart
Ligue cada venda aprovada na Hotmart à visita e à UTM que vieram antes dela. Reembolso e chargeback saem da receita no dia em que acontecem.
- Instale o script da Utmetrica na página de vendas.
- Em Configurações, cole o hottok da sua conta Hotmart.
- Na Hotmart, cadastre a URL do webhook (versão 2.0.0) que a Utmetrica mostra.
- O script repassa o visitante no parâmetro sck dos links de checkout, e a venda chega com a origem.
Eventos que a Utmetrica entende: Compra aprovada, Compra completa, Compra reembolsada, Chargeback. Página da integração: Hotmart.
Kiwify
Saiba qual anúncio trouxe cada venda da Kiwify. A Utmetrica confere a assinatura de cada webhook e liga a compra à visita com UTM.
- Instale o script da Utmetrica na página de vendas.
- Na Kiwify, abra Apps → Webhooks → Criar webhook e copie o token.
- Cole o token em Configurações e use a URL que a Utmetrica mostra no mesmo formulário.
- O script repassa o visitante no parâmetro sck dos links pay.kiwify.com.br.
Eventos que a Utmetrica entende: Compra aprovada, Assinatura renovada, Compra reembolsada, Chargeback. Página da integração: Kiwify.
Stripe
Ligue cada pagamento do Stripe à visita com UTM. Webhook assinado, evento gravado antes da resposta e reembolso fora de ordem tratado.
- Instale o script da Utmetrica no site.
- Em Configurações, crie a conexão Stripe e copie a URL do webhook.
- No Stripe, em modo teste, adicione o endpoint e cole o segredo de assinatura na Utmetrica.
- Passe o visitante em client_reference_id ao criar a Checkout Session.
Eventos que a Utmetrica entende: checkout.session.completed, charge.refunded. Página da integração: Stripe.
Cakto
Saiba qual anúncio trouxe cada venda da Cakto. A Utmetrica confere a assinatura de cada webhook e liga a compra à visita com UTM.
- Instale o script da Utmetrica na página de vendas.
- Na Cakto, abra Integrações → Webhooks, crie o webhook e copie o secret.
- Cole o secret em Configurações e troque a URL do webhook na Cakto pela que a Utmetrica mostra.
- O script repassa o visitante no parâmetro sck dos links pay.cakto.com.br. Confirme na primeira venda real que ele volta no webhook.
Eventos que a Utmetrica entende: Compra aprovada, Assinatura renovada, Reembolso, Chargeback. Página da integração: Cakto.
Hubla
Ligue cada fatura paga na Hubla à visita e à UTM que vieram antes dela. Reembolso e chargeback saem da receita no dia em que acontecem.
- Instale o script da Utmetrica na página de vendas.
- Na Hubla, abra Integrações → Automações → Webhook e copie o Hubla Webhook Token da aba Autenticação.
- Cole o token em Configurações e, na Hubla, adicione uma regra com a URL que a Utmetrica mostra.
- O script repassa o visitante no parâmetro sck dos links pay.hub.la, e a fatura chega com a origem.
Eventos que a Utmetrica entende: Pagamento da fatura realizado, Fatura reembolsada, Chargeback. Página da integração: Hubla.
Meta Ads
A Utmetrica lê o gasto do Meta Ads (somente leitura, nunca altera campanhas) e mostra ROAS e lucro bruto por campanha, conjunto e anúncio com a receita que o checkout confirmou, não a que o pixel estimou.
- Conecte um pagamento (Hotmart, Kiwify ou Stripe): sem receita confirmada não há ROAS.
- Em Anúncios, conecte o Meta com a permissão de leitura e marque as contas de anúncios.
- Cole o modelo de parâmetros de URL nos anúncios, para cada venda chegar com o número da campanha e do anúncio.
Eventos que a Utmetrica entende: Gasto por dia e por anúncio, Impressões e cliques, Campanha → conjunto → anúncio, Moeda e fuso da conta. Página da integração: Meta Ads.
Eduzz
Ligue cada fatura paga na Eduzz à visita e à UTM que vieram antes dela. Reembolso e chargeback saem da receita no dia em que acontecem.
- Instale o script da Utmetrica na página de vendas.
- Na Eduzz, abra Configurações → Segurança e copie a chave secreta do webhook.
- Cole a chave em Configurações e crie na Eduzz um webhook com a URL que a Utmetrica mostra.
- Use Verificar URL na Eduzz: o ping chega assinado e a conexão fica verde.
- O visitante volta nos códigos do rastreador (tracker.code1 a code3). Confirme na primeira venda real.
Eventos que a Utmetrica entende: Fatura paga, Reembolso, Chargeback perdido. Página da integração: Eduzz.
Monetizze
Ligue cada venda finalizada na Monetizze à visita e à UTM que vieram antes dela. A devolução sai da receita; chargeback não tem evento na Monetizze e não sai.
- Instale o script da Utmetrica na página de vendas.
- Na Monetizze, abra Ferramentas → Postback e copie a chave única da conta.
- Cole a chave em Configurações e cadastre na Monetizze o postback com a URL que a Utmetrica mostra.
- O visitante vai no parâmetro src do link de checkout e volta no campo src da venda. Confirme na primeira venda real.
Eventos que a Utmetrica entende: Venda finalizada ou completa, Devolução. Página da integração: Monetizze.
Ticto
Ligue cada venda autorizada na Ticto à visita e à UTM que vieram antes dela. Reembolso e chargeback saem da receita no dia em que acontecem.
- Instale o script da Utmetrica na página de vendas.
- Na Ticto, abra Integrações → Webhooks, crie um webhook da versão 2.0 e copie o token.
- Cole o token em Configurações e troque a URL do webhook na Ticto pela que a Utmetrica mostra.
- O visitante vai no parâmetro sck do link de compra e volta em tracking.sck. Confirme na primeira venda real.
Eventos que a Utmetrica entende: Venda autorizada, Reembolso, Chargeback. Página da integração: Ticto.
Perfect Pay
Ligue cada venda aprovada na Perfect Pay à visita e à UTM que vieram antes dela. Reembolso e chargeback totais saem da receita. Só vendas em reais são lidas.
- Instale o script da Utmetrica na página de vendas.
- Na Perfect Pay, abra Ferramentas → Webhook (postback) e copie o token do postback.
- Cole o token em Configurações e cadastre no postback a URL que a Utmetrica mostra, com os eventos de venda.
- Monte o link do checkout com src igual ao visitante da Utmetrica. Confirme na primeira venda real: a documentação não diz se o token é privado da sua conta.
Eventos que a Utmetrica entende: Venda aprovada, Venda completa, Reembolso, Chargeback. Página da integração: Perfect Pay.
Mercado Pago
Ligue cada pagamento aprovado no Mercado Pago à visita e à UTM que vieram antes dele. Reembolso total e chargeback saem da receita. Reembolso parcial ainda não é descontado.
- Instale o script da Utmetrica na página de vendas.
- No Mercado Pago, abra Suas integrações, escolha a aplicação e copie a assinatura secreta do webhook e o Access Token de produção.
- Cole os dois em Configurações e use no webhook da aplicação a URL que a Utmetrica mostra, com o tópico de pagamentos.
- Crie a preferência de pagamento com o visitante em external_reference. Confirme no primeiro pagamento real.
Eventos que a Utmetrica entende: Pagamento aprovado, Reembolso total, Chargeback. Página da integração: Mercado Pago.
Pagar.me
Ligue cada cobrança paga no Pagar.me à visita e à UTM que vieram antes dela. Só o que a API confirma vira receita. Reembolso total e chargeback saem da receita; reembolso parcial ainda não é descontado.
- Instale o script da Utmetrica na página de vendas.
- No Pagar.me, abra Configurações → Chaves e copie a chave secreta de produção (começa com sk_).
- Cole a chave em Configurações e cadastre a URL que a Utmetrica mostra como webhook, com os eventos de cobrança.
- Crie o pedido com o visitante em metadata.utmetrica_visitor_id. Confirme na primeira venda real.
Eventos que a Utmetrica entende: Cobrança paga, Reembolso total, Chargeback. Página da integração: Pagar.me.
Asaas
Ligue cada cobrança confirmada no Asaas (Pix, boleto, cartão) à visita e à UTM que vieram antes dela. Estorno e chargeback saem da receita no dia em que acontecem.
- Instale o script da Utmetrica na página de vendas.
- No Asaas, abra Integrações → Webhooks, crie um webhook e escolha um token de autenticação (32 a 255 caracteres).
- Cole o mesmo token em Configurações e use no Asaas a URL que a Utmetrica mostra.
- Crie as cobranças com o visitante no campo externalReference. Confirme na primeira cobrança real.
Eventos que a Utmetrica entende: Cobrança confirmada ou recebida, Estorno, Chargeback solicitado. Página da integração: Asaas.
Shopify
Ligue cada pedido pago na Shopify à visita e à UTM que vieram antes dele. Reembolso sai da receita no dia em que acontece.
- Instale o script da Utmetrica no tema e adicione o snippet que grava o visitante no carrinho.
- Na Shopify, abra Configurações → Notificações → Webhooks e copie o segredo que assina os webhooks.
- Cole o segredo em Configurações da Utmetrica e crie na Shopify os webhooks orders/paid e refunds/create com a URL que a Utmetrica mostra.
- Faça um pedido de teste (gateway de teste da Shopify): ele chega marcado como teste e é ignorado, mas a conexão fica verde.
Eventos que a Utmetrica entende: Pedido pago, Reembolso. Página da integração: Shopify.
Yampi
Ligue cada pedido aprovado na Yampi à visita e à UTM que vieram antes dele. A Yampi não tem webhook de reembolso, então a receita não desconta devoluções.
- Instale o script da Utmetrica na loja.
- Na Yampi, crie um webhook para o evento order.paid e copie a secret_key dele.
- Cole a chave em Configurações e use na Yampi a URL que a Utmetrica mostra.
- Grave o visitante nos metadados do pedido, na chave utmetrica_visitor_id. Confirme no primeiro pedido real.
Eventos que a Utmetrica entende: Pedido aprovado. Página da integração: Yampi.
Nuvemshop
Receita dos pedidos pagos da loja, lida na API da Nuvemshop depois de um aviso assinado. Reembolso total sai da receita; reembolso parcial ainda não. A Nuvemshop não repassa o visitante no pedido, então esta receita aparece sem origem atribuída.
- Peça ao administrador da Utmetrica para registrar o app no portal de parceiros da Nuvemshop e informar o ID e o segredo no servidor.
- Em Configurações → Pagamentos, clique em Conectar loja e autorize o app na Nuvemshop (leitura de pedidos).
- A Utmetrica cadastra sozinha os avisos de pedido pago, atualizado, cancelado e anulado.
- Confirme no primeiro pedido pago real: o formato do valor e do reembolso ainda precisa de homologação.
Eventos que a Utmetrica entende: Pedido pago, Reembolso total. Página da integração: Nuvemshop.
Google Ads
A Utmetrica lê o gasto do Google Ads (somente leitura, nunca altera campanhas) e mostra ROAS, CPA, CAC e lucro por anúncio com a receita que o checkout confirmou, mais a diferença entre o que a plataforma reporta e o que foi vendido de fato.
- Conecte um pagamento (Hotmart, Kiwify ou Stripe): sem receita confirmada não há ROAS.
- Em Anúncios, escolha Google Ads, conecte a conta e marque as contas de anúncios.
- Cole o modelo de parâmetros de URL nos anúncios, para cada venda chegar com o número da campanha e do anúncio.
Eventos que a Utmetrica entende: Gasto por dia e por anúncio, Conversões que a plataforma reporta, Campanha, grupo e anúncio, Moeda e fuso da conta. Página da integração: Google Ads.
TikTok Ads
A Utmetrica lê o gasto do TikTok Ads (somente leitura, nunca altera campanhas) e mostra ROAS, CPA, CAC e lucro por anúncio com a receita que o checkout confirmou, mais a diferença entre o que a plataforma reporta e o que foi vendido de fato.
- Conecte um pagamento (Hotmart, Kiwify ou Stripe): sem receita confirmada não há ROAS.
- Em Anúncios, escolha TikTok Ads, conecte a conta e marque as contas de anúncios.
- Cole o modelo de parâmetros de URL nos anúncios, para cada venda chegar com o número da campanha e do anúncio.
Eventos que a Utmetrica entende: Gasto por dia e por anúncio, Conversões que a plataforma reporta, Campanha, grupo e anúncio, Moeda e fuso da conta. Página da integração: TikTok Ads.
Eduzz, Ticto, Asaas, Shopify, Monetizze, Yampi e Mercado Pago estão em beta: o adaptador foi testado com dados de exemplo, mas ainda não com uma venda real. No Mercado Pago o aviso traz só o número do pagamento, então a Utmetrica consulta o pagamento com o seu Access Token. A conciliação periódica cobre Stripe, Asaas e Shopify (as duas últimas em beta). Perfect Pay (postback com token), Pagar.me (o aviso só dispara a leitura da cobrança com a sua chave secreta) e Nuvemshop (app de parceiro, liga só quando o administrador o registra) estão em beta e ainda não foram homologadas com uma venda real. Greenn e Braip ainda não funcionam: a documentação pública da Greenn não descreve nenhuma autenticação do webhook e a Braip não publica o formato do postback. As demais plataformas do catálogo (Google Ads e outras) estão planejadas e ainda não funcionam. A lista completa e o estado de cada uma estão em Integrações.