Conectando a Payt: recovery de vendas passo a passo

A Payt tem adaptador nativo no Autopilot: os postbacks dela são interpretados automaticamente, sem precisar configurar mapeamento de eventos. Você cola uma URL na Payt e o Autopilot passa a receber cada boleto gerado, PIX criado, pagamento confirmado, cartão recusado, reembolso e chargeback — e dispara os funis de recuperação que você configurar.

Passo a passo

• 1. No Autopilot, vá em Recuperação → Integrações e clique em Nova Integração.
• 2. Selecione a plataforma Payt, dê um nome (ex.: "Payt — Loja Principal") e salve.
• 3. O Autopilot gera um token único e mostra a URL do webhook, no formato https://api.autopilotbr.com/webhook/recovery/SEU-TOKEN. Copie com o botão ao lado.
• 4. Na Payt, vá em Configurações → Webhook, cole a URL e configure os eventos desejados (recomendado: todos os status de transação).
• 5. Faça uma transação de teste ou aguarde o primeiro evento real. Ele aparece em Recuperação → Eventos.
• 6. Vá em Recuperação → Funis e crie os funis por tipo de evento (boleto gerado, PIX gerado, cartão recusado etc.). Sem funil ativo, o evento é registrado mas nenhuma mensagem é enviada.

O que o adaptador da Payt entende

A Payt envia postbacks baseados em status, e o adaptador resolve o evento correto mesmo nos casos ambíguos: distingue reembolso de cartão recusado, detecta boleto/PIX expirado e chargeback. Eventos reconhecidos incluem: boleto gerado, boleto pago, boleto vencido, PIX gerado, PIX pago, PIX expirado, cartão aprovado, cartão recusado, cartão cancelado, reembolso e chargeback. Valores em centavos são convertidos automaticamente.

Se a Payt não informar vencimento do boleto, o Autopilot assume 3 dias corridos — é isso que alimenta os lembretes de "vence amanhã" e "vence hoje", gerados internamente pelo agendador.

Dica de operador: os produtos são criados automaticamente na primeira venda de cada um — você não precisa cadastrar produto antes. Depois do primeiro evento, revise em Recuperação → Produtos e ajuste as configurações de cada produto.

Problemas comuns

• Evento não chegou: confira se a URL foi colada completa (com o token no final) e se a integração está ativa no Autopilot.
• Evento chegou mas nada foi enviado: quase sempre é funil inexistente ou inativo para aquele tipo de evento. Verifique em Recuperação → Funis.
• Evento duplicado: o Autopilot deduplica webhooks repetidos por 24 horas automaticamente — retentativas da Payt não geram mensagem dupla.
• Regenerei o token e parou de funcionar: regenerar invalida a URL antiga. Há um período de tolerância de 7 dias, mas atualize a URL na Payt o quanto antes.