Para o gestor de tráfego, um gateway de pagamento serve para duas coisas: o cliente receber sem atrito e a venda voltar para a campanha. Quando o Pix é pago no app do banco, longe da página, a compra some do gerenciador e a otimização trabalha com menos vendas do que existiram. Na NewPag, o caminho se monta com o desenvolvedor do cliente: o número do pedido vai na cobrança, o aviso de pagamento chega ao servidor e o servidor envia a compra à plataforma de anúncio. Abaixo, quem faz o quê, o roteiro para o desenvolvedor e o que conferir antes de subir.
Quem faz o quê
| Quem | Responsabilidade |
|---|---|
| Cliente, dono da conta | Abre a conta da empresa na NewPag, envia os documentos, cadastra a chave Pix de saque e libera os acessos |
| Desenvolvedor do cliente | Integra a API, recebe os webhooks e envia o evento de compra pelo servidor |
| Gestor de tráfego | Define o padrão de UTMs, configura o evento de compra no gerenciador, acompanha os testes e lê os resultados |
Não peça a senha do cliente nem a chave secreta da API. O segredo aparece uma vez só, quando é criado, e deve ficar no servidor de quem integra.
Acesso ao painel do cliente
Em Minha empresa, na aba Usuários e permissões, o dono da conta convida pessoas por e-mail e escolhe a função: Proprietário, Gerente ou Analista. Para o gestor de tráfego, Analista costuma bastar:
- vê o painel, as transações, os links de pagamento, os produtos, os saques e as disputas;
- exporta as transações em CSV;
- não cria cobranças nem links, não pede saque e não vê as chaves de API.
O convite chega por e-mail e vale por 7 dias.
Como montar o rastreio com o desenvolvedor
O roteiro técnico, com os campos de cada plataforma, está em como rastrear vendas Pix no Meta Ads e no TikTok Ads. O que você combina com o desenvolvedor cabe em cinco pontos:
- O que guardar na chegada. As UTMs do seu padrão e o identificador de clique de cada plataforma, salvos com o pedido.
- Número do pedido na cobrança. Ao criar o Pix pela API, o pedido vai no campo
external_reference, que volta em todos os avisos daquela cobrança. Com umaIdempotency-Keypor pedido, uma nova tentativa não gera outro Pix. - Avisos assinados. Em Integrações > Webhooks, o endpoint do cliente assina
transaction.paide, se houver recuperação de Pix pendente,transaction.pending. Cada aviso traz uma assinatura que o servidor confere antes de confiar nele. - Evento de compra pelo servidor. Ao receber
transaction.paid, o sistema encontra o pedido e envia a compra com valor, moeda e o número do pedido como identificador do evento, para a mesma venda não ser contada duas vezes. - Teste sem dinheiro. Com uma chave de teste, o desenvolvedor cria cobranças e simula o pagamento. O aviso chega marcado com
livemode: falsee não pode dar baixa em pedido real.
Hoje a NewPag não dispara pixel de anúncio. Sem integração, a venda Pix não chega sozinha ao gerenciador: o evento de compra precisa sair do servidor do cliente.
Sem desenvolvedor: um link por campanha
Se o cliente vende pelo link de pagamento e não tem quem integre, crie um link por campanha ou por conjunto de anúncios. Cada link mostra no painel os acessos, os pagamentos e a conversão, e você compara de onde vieram as vendas.
Não dá para otimizar a campanha pela compra só com isso, mas dá para cortar o que não vende.
O que conferir antes de subir a campanha
- Conta aprovada. Toda conta nasce em análise. O link de uma conta em análise mostra que não está disponível e não gera Pix. Enquanto isso, a chave de teste já permite integrar.
- Ticket dentro dos limites. Em Minha empresa, aba Limites e taxas, ficam a cobrança mínima e a máxima. Fora dessa faixa, o Pix não é gerado.
- Limite da API. Na mesma aba aparece o limite de requisições por minuto, que vale para a conta toda. Acima dele, a API pede para esperar e tentar de novo.
- Pagamento no celular. Abra o link pelo Instagram e pelo TikTok, no Android e no iPhone, e pague um Pix de valor baixo. O roteiro está em Pix no navegador do Instagram e do TikTok.
- Evento chegando. Na ferramenta de teste de eventos da plataforma de anúncio, confira se a compra chega com valor e com o identificador do pedido.
- Pix pendente. Combine com o cliente o que fazer com quem gerou o Pix e não pagou. Veja Pix gerado e não pago e as regras de disparo de WhatsApp para recuperar vendas.
- CPA máximo. Com a taxa da conta, que aparece na tela Taxas, calcule quanto a campanha pode pagar por venda na calculadora de ROAS.
Leia os números juntos
Uma vez por semana, compare as compras do gerenciador com as vendas pagas em Transações, no mesmo período. A exportação em CSV facilita a conta. Se o gerenciador mostra bem menos compras, o evento não está saindo ou chega sem os dados do clique. Se mostra mais, a mesma venda pode estar sendo contada duas vezes, e o identificador do evento precisa ser revisto.
Indique a NewPag e ganhe comissão
Se você indica a NewPag aos seus clientes, o Indique e ganhe paga comissão por isso. As regras:
- O link de indicação fica na tela Indicações da sua conta NewPag.
- A empresa precisa se cadastrar por esse link. Ela aparece como convidada e passa a ativada quando a conta é aprovada.
- A comissão nasce de cada pagamento confirmado da empresa indicada: um percentual do valor, um valor fixo por pagamento ou os dois, conforme as condições da NewPag. As que valem para você podem ser consultadas com o suporte.
- Cada pagamento gera comissão uma vez, e o estorno de uma cobrança desfaz a comissão dela.
- A comissão é creditada no seu saldo disponível e pode ser sacada por Pix.
- Ela não sai do valor do seu cliente: a empresa indicada recebe a venda menos a taxa da própria conta.
Conte ao cliente que você participa do programa. A recomendação fica mais forte quando é às claras.
O que a NewPag não faz hoje
A NewPag recebe por Pix. Ela não aceita cartão de crédito nem faz cobrança recorrente automática. O checkout também não tem pixel de anúncio próprio. E não captura UTMs sozinho: a origem da venda fica no sistema do cliente ou no link de cada campanha.
A visão completa para quem anuncia está em gateway de pagamento para tráfego pago.
Perguntas frequentes
O gestor de tráfego precisa ter conta na NewPag?
Para acompanhar as vendas do cliente, não: o cliente convida você como usuário do painel dele, com a função Analista. Para receber comissão pelo Indique e ganhe, sim: o link de indicação fica na tela Indicações da sua própria conta.
Como a venda Pix chega ao gerenciador de anúncios?
Pelo servidor do cliente. A cobrança é criada pela API com o número do pedido em external_reference, o webhook transaction.paid avisa o pagamento e o sistema do cliente envia o evento de compra pela API de conversões da plataforma, com o número do pedido como identificador do evento.
Consigo ver as vendas do cliente sem acesso a saques?
Sim. Em Minha empresa, na aba Usuários e permissões, o cliente convida você com a função Analista. Ela vê painel, transações, links, produtos e disputas e exporta as transações, mas não cria cobranças, não pede saque e não vê as chaves de API.
Quanto o gestor ganha indicando a NewPag?
A comissão é calculada sobre cada pagamento confirmado da empresa indicada: um percentual, um valor fixo por pagamento ou os dois, conforme as condições que a NewPag define para o programa. Para saber as que valem para você, fale com o suporte pelo painel.