A PushinPay é Pix por API: quem vende com ela quase sempre cria a cobrança por um sistema — um bot de Telegram ou WhatsApp, um checkout próprio — e recebe o aviso quando o Pix é pago. O UTMizey lê esse aviso e coloca a venda no painel.
Mas é bom saber logo de cara o que esse aviso traz, porque é ele que decide o que dá para medir. O webhook da PushinPay não traz a campanha da venda, nem a taxa, nem o produto. Este texto mostra como ligar, o que entra no painel e como saber qual anúncio vendeu mesmo assim.
O que o webhook da PushinPay traz
| Traz | Não traz |
|---|---|
| O identificador da cobrança | A campanha, o conjunto e o anúncio |
| O valor, em centavos | A taxa da PushinPay |
| O estado: criado, pago ou cancelado | O produto vendido |
| Os dados de quem pagou, depois do pagamento | A data do pagamento |
Na prática, isso quer dizer duas coisas. As vendas entram no painel sem campanha, contadas no faturamento e marcadas como sem rastreio. E o lucro só sai certo se você disser ao UTMizey quanto a PushinPay cobra.
Passo 1: a URL vai em cada cobrança
No UTMizey, abra Integrações → Webhooks, escolha a PushinPay e clique em Gerar URL do webhook.
Na PushinPay não existe uma tela de webhooks com eventos para marcar: o endereço vai no campo webhook_url de cada cobrança Pix que o seu sistema cria. Quem programou o bot ou o checkout coloca a URL do UTMizey nesse campo, e a partir daí cada mudança de estado daquela cobrança chega ao painel.
Só nas cobranças, não nas transferências
A PushinPay usa o mesmo formato de aviso para o Pix que você recebe e para o que você envia. Use a URL do UTMizey só nas cobranças. Se ela for parar numa transferência, o UTMizey reconhece os campos do recebedor e ignora o aviso — saque não vira venda —, mas o certo é não mandar.
Passo 2: a taxa em Taxas
Como a taxa não vem no aviso, o UTMizey registra cada venda pelo valor cheio. Cadastre a taxa da PushinPay em Taxas — percentual, valor fixo por venda ou os dois, como estiver no seu contrato —, e o faturamento líquido e o lucro passam a sair descontados. Chutar um percentual do nosso lado seria inventar número no seu Lucro.
O que cada aviso vira no painel
- Criado entra como venda pendente: o Pix foi gerado e ainda não foi pago.
- Pago vira venda aprovada, com a hora em que o aviso chegou — a PushinPay não manda a data do pagamento.
- Cancelado antes de pagar é cobrança que expirou ou foi cancelada. Dinheiro nenhum entrou, e a venda fica como recusada.
- Cancelado depois de pagar é devolução. O UTMizey reconhece pelos dados do pagamento que vêm junto, e a venda passa a reembolsada.
Aviso atrasado não desfaz venda paga
Sem data no aviso, a ordem sai do próprio estado. Se o aviso de “criado” chegar atrasado, depois do “pago”, ele não devolve a venda para pendente.
E para saber qual anúncio vendeu?
Pelo webhook da PushinPay, não dá: a informação não está lá. Quem precisa da campanha em cada venda tem um caminho, que é o sistema que cria a cobrança mandar a venda ao UTMizey pela API de envio de vendas, com as UTMs com que o comprador chegou.
O seu bot ou checkout já sabe quando o Pix foi pago, porque é ele que recebe o aviso da PushinPay. Na mesma hora, ele manda o pedido ao UTMizey com o valor, o estado e a origem. Se o anúncio usa o código de UTMs do painel, a venda cai na mesma linha do gasto daquele anúncio.
Um caminho só por venda
Escolha o webhook da PushinPay ou a API para cada venda, não os dois. São duas entradas diferentes, e a mesma venda mandada pelas duas aparece duas vezes no faturamento.
Vende por bot? Guarde a origem na primeira mensagem
Num bot de Telegram ou WhatsApp, a UTM existe no link que abriu a conversa e em nenhum outro lugar. Se o bot não guardar esses parâmetros junto do contato logo no começo, não há de onde tirá-los quando o Pix for pago, horas depois.
Em uma frase
A PushinPay avisa que o Pix foi gerado, pago ou cancelado, e o UTMizey põe cada venda no painel com o estado certo; a taxa você cadastra em Taxas, e a campanha só vem se o sistema que cria a cobrança mandar a venda pela API com as UTMs.
PushinPay no painel em poucos minutos
No UTMizey, a URL do webhook sai pronta para ir no webhook_url das suas cobranças, e a API de vendas está lá para quando você quiser a campanha em cada Pix. O plano gratuito cobre até 30 vendas aprovadas por mês.