Suporte/Solução de problemas
Solução de problemas

Por que os pagamentos aparecem duplicados?

Pagamentos duplicados normalmente significam que a mesma compra foi registrada mais de uma vez.

O que realmente impede os duplicados

Na implementação atual do backend, a proteção contra duplicados se baseia em um transactionId estável.

  • Se você enviar novamente o mesmo transactionId, o Flowsery pode atualizar o registro de pagamento existente em vez de criar um novo.
  • Se você enviar IDs diferentes para a mesma compra, o Flowsery não consegue eliminar os duplicados de forma confiável.

Causas comuns

  • Registrar um pagamento tanto a partir de um webhook do provedor como de uma chamada personalizada na página de sucesso.
  • Gerar um identificador de transação diferente em cada nova tentativa.
  • Misturar uma integração com um provedor de pagamentos conectado e chamadas manuais à Payment API para a mesma compra.

Como resolver

Escolha um único caminho de registro por compra:

  1. Use a integração com o provedor conectado, ou
  2. Use a Payment API com um transactionId estável

Se você usar a Payment API diretamente, prefira os nomes de campo reais do backend, como visitorUid e sessionUid.