Use a integração Payt para receber pedidos pagos por postback. Com uma Partner Key, o Paylog também pode devolver o rastreio após o despacho.
1. Crie a integração
Em Ferramentas > Integrações > Todas as integrações, abra o cartão Payt, clique em Nova integração e informe:
- o Identificador/Usuário da conta;
- a Data de início e a Hora de início;
- a Partner Key (Opcional), usada pelo Paylog para devolver o rastreio à Payt.
Eventos cuja data de pagamento seja anterior ao início serão ignorados permanentemente. Revise data, hora e fuso antes de salvar.
A Partner Key é fornecida pela Payt para a configuração do parceiro logístico. O próprio formulário do Paylog traz o link Ver instruções, que abre o artigo da Payt sobre como configurar um parceiro de logística.
A URL de postback traz as vendas da Payt para o Paylog. A Partner Key faz o caminho inverso e permite que o Paylog envie o código de rastreio depois do despacho. Para manter o rastreio atualizado na Payt, é importante configurar essa chave e habilitar o envio automático.
2. Configure o webhook
Salve a integração, abra a aba Webhooks da página da Payt e clique em Copiar URL. No painel Payt, acesse Ferramentas > Postbacks > Cadastrar, escolha o tipo PayT V1 e cadastre a URL. Confirme na documentação atual da Payt quais eventos devem ser selecionados.
O pedido só é criado quando o status do pagamento chega como paid ou approved. pending, waiting_payment, processing, canceled, refused e declined são registrados sem criar pedido.
3. Relacione o produto ao pacote
O Paylog procura primeiro o SKU do produto enviado pela Payt; se ele não vier preenchido, usa o código do produto.
Em Catálogo > Pacotes, crie ou edite o pacote e, em Plataformas > Referências, adicione Payt com o mesmo SKU usado na oferta.
Para evitar ambiguidade, mantenha um SKU estável e exclusivo para cada composição física vendida.
4. Envie o rastreio
Depois de salvar a Partner Key no cartão da integração, na aba Configurações, confirme o status ATIVO e ative Enviar rastreio automaticamente (o botão fica bloqueado enquanto não houver Partner Key salva). O Paylog enviará o rastreio à Payt quando o pedido for despachado.
O envio também depende de o serviço de rastreio da Payt e a chave correspondente estarem habilitados na configuração administrativa do Paylog. Se a Partner Key estiver correta, mas nenhum rastreio for enviado, peça ao suporte Paylog para confirmar essa configuração.
5. Teste e acompanhe
Faça uma venda aprovada com um produto físico. Confira Último postback, Ferramentas > Integrações > Postbacks e o pedido criado. Se houver order bump ou upsell físico, confirme também se a composição final ficou correta.
| Situação | O que verificar |
|---|---|
| Pacote não encontrado | SKU ou código recebido diferente da referência Payt. |
| Fora de Prazo | Pagamento anterior à data e hora de início. |
| Rastreio não enviado | Partner Key ausente ou inválida, envio automático desativado ou serviço/chave Payt não habilitado na administração do Paylog. |
| Item não entrou no pedido | Order bumps e upsells marcados como digital são descartados; só physical e grouped entram na separação. |
| Venda inteira ignorada | O campo tangible da venda veio como falso na Payt. |