Contexto
Uma simulação financeira precisa continuar coerente quando vira proposta e, depois, pagamento. A PixPan reúne cálculo direto e reverso, tabelas de taxas, operações físicas e digitais e acompanhamento por equipes. O desafio foi conectar essas etapas sem perder as condições que o cliente e o operador haviam consultado.
Minha participação
Na PuggyWare, atuei de ponta a ponta no desenvolvimento, conectando experiência web, regras de cálculo, persistência, integração de pagamento e acompanhamento operacional. Participei também das decisões sobre permissões, relatórios e recuperação de eventos que chegam fora do fluxo esperado.
Como funciona
- A simulação parte do valor desejado ou do valor a cobrar, aplicando a tabela e o número de parcelas autorizados.
- A proposta guarda as condições calculadas. A criação ou reutilização do link de pagamento respeita a versão dessa proposta.
- O webhook é validado e persistido em uma caixa de entrada antes do processamento, com controle de repetição e novas tentativas.
- O processador confere valor, moeda e recebedor; a reconciliação recupera pendências e os relatórios respeitam o escopo do usuário.
Decisões técnicas
Preservar a condição comercial
Cálculos com decimal e snapshots da proposta mantêm os valores vinculados às taxas autorizadas naquela operação. Alterar uma tabela não deve reescrever silenciosamente uma condição já apresentada.
Tratar confirmação como processamento durável
Inbox persistida, processamento com lease e reconciliação separam o recebimento do evento de sua aplicação. Isso permite recuperar falhas e lidar com notificações repetidas sem depender de uma única requisição bem-sucedida.
Aprendizados
Aprendi a tratar o estado financeiro como uma sequência de evidências: uma simulação, uma proposta e uma confirmação têm responsabilidades diferentes. Tornar essas transições explícitas ajuda tanto a experiência do operador quanto a investigação de inconsistências.
Limites e próximos passos
- Confirmar um pagamento no gateway não comprova um desembolso Pix automático ao destinatário.
- A imagem mostra a página pública; dados de clientes, propostas e resultados operacionais não são apresentados.
Créditos
Desenvolvido na PuggyWare, em colaboração com a equipe.