As integrações de pagamento recebem as vendas aprovadas por postback e criam os pedidos no Paylog. Antes de conectar uma plataforma, cadastre os produtos físicos e monte os pacotes que serão expedidos.
Como funciona
Cada plataforma tem uma página só dela, com quatro abas: Configurações (as conexões, os tokens e o último postback recebido), Mapeamento (a fila de códigos que chegaram sem pacote ou sem produto relacionado), Webhooks (a URL de postback de cada conexão, com Copiar URL) e Instruções (o passo a passo daquela plataforma).
A aba Mapeamento só aparece para quem tem permissão de ver as referências sem pacote. Na SkaleTracking e na YouShop ela também depende de o Paylog ter liberado a integração para a sua conta.
O fluxo é o mesmo na maioria delas:
- no Paylog, acesse Ferramentas > Integrações > Todas as integrações e abra o cartão da plataforma;
- clique em Nova integração e salve — a URL de postback é gerada na hora;
- na aba Webhooks, clique em Copiar URL e cadastre essa URL no painel da plataforma de pagamento;
- em Catálogo > Pacotes, relacione o código da oferta, plano ou SKU ao pacote correto;
- na aba Configurações, confira que a integração aparece com o status ATIVO;
- faça uma venda de teste e confira o primeiro postback.
A integração já é criada Ativa — não existe um botão de ligar/desligar na tela. Para interromper o recebimento, exclua a integração pelo ícone de lixeira no cartão.
Webhook e token têm funções diferentes
- a URL de webhook/postback é cadastrada na plataforma de pagamento para ela enviar as vendas ao Paylog;
- quando a integração oferece Token da API ou Partner Key, essa credencial permite o caminho inverso: o Paylog envia o código de rastreio à plataforma depois que o pedido é despachado.
Nas integrações que oferecem Token da API ou Partner Key, configure a credencial e habilite o envio automático de rastreio. Sem ela, o postback ainda pode trazer a venda ao Paylog, mas o Paylog não consegue devolver o código de rastreio à plataforma.
A Data de início e a Hora de início formam um corte definitivo. Se a data do pagamento recebida no postback for anterior a esse instante, o evento será marcado como Fora de Prazo, será ignorado permanentemente e não criará pedido. Escolha o momento correto antes de ativar o webhook.
O corte só é aplicado quando a plataforma envia uma data de pagamento no postback. O formato legado da Hotmart (v1), por exemplo, não envia essa data — nesse caso nenhum evento é barrado pelo corte.
Na SkaleTracking, o Paylog não pede essa data: todas as integrações usam automaticamente o corte fixo 01/07/2026 00:00, inclusive as criadas no futuro.
Escolha a plataforma
Se um pedido não aparecer
Em Ferramentas > Integrações > Postbacks (página Postbacks Recebidos), confira se o evento chegou e como foi classificado. Os motivos mais comuns são data anterior ao início da integração, código sem pacote, produto digital, integração excluída ou dados incompletos enviados pela plataforma.
Quando o motivo for código sem pacote, a aba Mapeamento da própria plataforma lista as referências que chegaram sem pacote correspondente — resolva o vínculo por lá.
O Paylog só cria o pedido quando o postback informa um pagamento aprovado. Eventos de pedido pendente, boleto/PIX gerado, recusado ou abandono chegam e ficam registrados, mas não geram pedido — a aprovação sempre chega depois como um novo postback.