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:
- Use a integração com o provedor conectado, ou
- Use a Payment API com um
transactionIdestável
Se você usar a Payment API diretamente, prefira os nomes de campo reais do backend, como visitorUid e sessionUid.