--- title: "Integração Perfect Pay: webhook de vendas e trackeamento" description: "Integre a Perfect Pay ao Sparkle Tracker pelo webhook: 8 eventos, da venda ao reembolso, cada um ligado ao anúncio de origem. Passo a passo completo." url: https://sparkletracker.com/integracoes/perfectpay updated: 2026-11-12 language: pt-BR --- **INTEGRAÇÃO NATIVA** Perfect Pay # Integração Perfect Pay e Sparkle Tracker: _cada venda ligada ao anúncio de origem_ A Perfect Pay avisa o Sparkle Tracker pelo webhook a cada venda, a cada pagamento gerado e a cada devolução. O Sparkle liga o evento ao lead, mostra de qual campanha, conjunto e criativo ele veio e envia a compra para o Meta e o Google. Webhook de vendas Compra enviada ao Meta e ao Google A partir do plano Pro [Teste grátis por 7 dias](https://sparkletracker.com/planos#planos) [Ver o passo a passo](https://sparkletracker.com/integracoes/perfectpay#passo-a-passo) **8** eventos da Perfect Pay lidos pelo Sparkle **4** efeitos no painel: venda aprovada, venda iniciada, checkout iniciado e reembolso Resposta rápida ## Como rastrear as vendas da Perfect Pay por anúncio? Para saber de qual anúncio veio cada venda da Perfect Pay, cadastre na Perfect Pay o link de webhook do **Sparkle Tracker**. A cada venda, a Perfect Pay avisa o Sparkle, que liga a venda ao lead pelo telefone ou pelo e-mail do comprador. O lead já tem a campanha, o conjunto e o criativo do clique. A venda aparece no painel com essa origem e segue para o Meta e para o Google como compra. A venda devolvida desconta o valor do faturamento. É uma das [integrações nativas](https://sparkletracker.com/integracoes) do Sparkle Tracker. Atualizado em 12 de novembro de 2026 **Webhook** da Perfect Pay **8 eventos** lidos, da venda ao reembolso Venda com **campanha, conjunto e criativo** O que chega ## Quais eventos da Perfect Pay _o Sparkle Tracker recebe?_ São os eventos que você marca ao cadastrar o webhook na Perfect Pay. Cada um tem um efeito diferente no painel. Eventos da Perfect Pay e o efeito de cada um no Sparkle Tracker | Evento na Perfect Pay | No Sparkle Tracker | Efeito | | --- | --- | --- | | Venda aprovada status 2 | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google | | Venda completa status 10 | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google | | Pendente, com boleto ou Pix gerado status 1 | Venda iniciada | Mostra quem gerou o pagamento e ainda não pagou. Não conta como venda | | Em análise ou autorizada status 3, 8 e 16 | Venda iniciada | Mostra quem gerou o pagamento e ainda não pagou. Não conta como venda | | Pré-checkout, abandono status 12 | Checkout iniciado | Entra no funil como início de checkout, para recuperar quem não terminou | | Cancelado status 6 | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado | | Reembolso status 7 | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado | | Chargeback status 9 | Reembolso | Desconta o valor do faturamento, para o ROAS do anúncio não ficar inflado | Pixel e UTM ## Pixel no checkout da Perfect Pay _ou venda pelo webhook?_ O pixel no checkout depende do navegador do comprador. O webhook sai do servidor da Perfect Pay e chega ao Sparkle com a venda confirmada. Como a origem do anúncio chega até a venda da Perfect Pay | Pergunta | Como funciona com o Sparkle Tracker | | --- | --- | | Quem avisa que a venda aconteceu | A Perfect Pay, pelo webhook, de servidor para servidor. Não depende do navegador nem de a pessoa voltar para a página de obrigado. | | Como a venda acha o anúncio | Pelo telefone ou e-mail do comprador, que o Sparkle compara com o lead. O lead já carrega a campanha, o conjunto e o criativo do primeiro clique. | | Para onde vão as UTMs | Na Venda Direta, o script do Sparkle guarda as UTMs por 30 dias e acrescenta UTMs, src, sck e xcod em todo link que leva ao checkout. O checkout guarda esses campos e devolve na venda. | | O que volta para o Meta e o Google | A compra (Purchase) com a origem, enviada pelo Sparkle. Para o Google Ads, a conversão vai quando o clique veio de um anúncio do Google. | A venda confirmada pelo gateway _não depende do que o navegador deixou passar._ Passo a passo ## Como integrar a Perfect Pay _ao Sparkle Tracker_ Você precisa de uma operação criada no Sparkle e de acesso de administrador ou produtor na Perfect Pay. ### 1Ative a integração no Sparkle 1. No painel do Sparkle, abra **Integrações**, encontre o cartão **Perfect Pay** e clique em **Ativar integração**. 2. Em **Operação**, escolha de qual operação são as vendas e clique em **Continuar**. 3. Copie o link de webhook gerado pelo botão ao lado dele, sem montar o endereço à mão. Cada operação tem um link próprio. Para vender em mais de uma operação, gere um link para cada. ### 2Crie o webhook na Perfect Pay 1. Na Perfect Pay, abra **Ferramentas**, **Webhook**. 2. Clique no botão de criar webhook. 3. Em **Nome**, escreva um nome que identifique a operação. 4. No campo de **URL**, cole o link copiado do Sparkle. 5. Se a tela pedir o produto, escolha o produto vendido nessa operação. 6. Marque todos os eventos da tabela acima e salve o webhook. Opcional: na mesma tela de Webhook da Perfect Pay, copie o **Token** e cole no Sparkle, nas credenciais da integração. Com ele salvo, só é aceita a venda que chega com o mesmo token. ### 3Teste com uma compra 1. Faça uma compra de teste, ou use o botão de teste do painel, se houver. 2. No Sparkle, abra **Logs de Eventos**: a chamada aparece em poucos segundos. 3. Abra **Leads Capturados** e clique no comprador. Em Histórico de ações, a venda aparece com gateway, produto e valor. O guia com as telas está na documentação: [integração Perfect Pay no Sparkle Tracker](https://docs.sparkletracker.com/perfectpay). A mesma integração por webhook também está pronta para [Kirvano](https://sparkletracker.com/integracoes/kirvano), [Yampi](https://sparkletracker.com/integracoes/yampi), [Doppus](https://sparkletracker.com/integracoes/doppus), [Braip](https://sparkletracker.com/integracoes/braip), [Payt](https://sparkletracker.com/integracoes/payt), [Ticto](https://sparkletracker.com/integracoes/ticto) e [Logzz](https://sparkletracker.com/integracoes/logzz), além de [Hotmart](https://sparkletracker.com/integracoes/hotmart), [Kiwify](https://sparkletracker.com/integracoes/kiwify), [Cakto](https://sparkletracker.com/integracoes/cakto) e [Eduzz](https://sparkletracker.com/integracoes/eduzz). Do mesmo assunto ## Outras integrações _e o que fazer com a venda_ [**Integração Kirvano** Eventos e passo a passo do webhook da Kirvano](https://sparkletracker.com/integracoes/kirvano)[**Integração Yampi** Eventos e passo a passo do webhook da Yampi](https://sparkletracker.com/integracoes/yampi)[**Integração Doppus** Eventos e passo a passo do webhook da Doppus](https://sparkletracker.com/integracoes/doppus)[**Trackeamento de vendas** Como a venda do gateway é ligada ao lead e ao anúncio](https://sparkletracker.com/trackeamento-de-vendas)[**Todas as integrações** Gateways, e-commerces, pixels, CRMs, API e webhooks](https://sparkletracker.com/integracoes)[**Trackeamento de venda direta** Página de vendas e checkout, sem WhatsApp no meio](https://sparkletracker.com/venda-direta) FAQs ## Dúvidas sobre _a integração Perfect Pay_ Ative a integração Perfect Pay no painel do Sparkle Tracker e escolha a operação. Copie o link de webhook gerado e cadastre esse link na Perfect Pay, marcando todos os eventos de venda, pagamento pendente e devolução. Uma compra de teste confirma se a venda chegou. É o aviso que a Perfect Pay, gateway de pagamentos brasileiro para produtores digitais e afiliados, manda de servidor para servidor a cada evento de venda. Você cadastra um endereço na Perfect Pay e escolhe os eventos. Para o Sparkle Tracker, esse endereço é o link gerado na integração. São 8: venda aprovada, venda completa, pendente, com boleto ou pix gerado, em análise ou autorizada, pré-checkout, abandono, cancelado, reembolso e chargeback. Cada um vira um efeito no painel: venda aprovada, venda iniciada, checkout iniciado e reembolso. Sai. Com os eventos de devolução marcados no webhook, o valor é descontado do faturamento, e o ROAS e o lucro do anúncio que trouxe a venda ficam corretos. Há duas causas comuns. O comprador usou no checkout um telefone ou e-mail diferente do que tinha como lead, e a venda entrou como um lead novo de Venda Direta. Ou o anúncio estava sem o modelo de UTM nos parâmetros de URL. O modelo fica em Operações e UTMs, na aba UTMs. As integrações com checkouts, gateways e e-commerces fazem parte dos planos Pro, Expert e Growth. [Ver os planos](https://sparkletracker.com/planos). ## Veja de qual anúncio veio _a próxima venda da Perfect Pay._ Ative a integração, cadastre o webhook e acompanhe a venda voltar ao criativo de origem. 7 dias grátis no plano mensal. [Iniciar o teste grátis](https://sparkletracker.com/planos#planos) --- Versão em Markdown de https://sparkletracker.com/integracoes/perfectpay para agentes de IA. Índice do site: https://sparkletracker.com/llms.txt