Planeje uma integração de pagamentos que trate notificações repetidas, estornos e conciliação sem confundir cobrança com recebimento.
Índice
Uma tela de pagamento aprovado não deve ser a única evidência usada para liberar um pedido. A integração entre provedor e ERP precisa confirmar o evento por um canal confiável, associá-lo ao registro correto e lidar com mensagens repetidas ou fora de ordem.
Desenhe os estados da operação
Pedido criado, cobrança emitida, pagamento confirmado, cancelamento e estorno representam situações diferentes. Documente quais transições são permitidas e quem pode executá-las. Um pagamento parcial ou um estorno posterior precisa refletir no saldo e no atendimento ao cliente.
O que pedir na proposta técnica
Inclua validação da origem das notificações, consulta ao provedor quando necessária e processamento idempotente: receber o mesmo evento duas vezes não pode gerar dois créditos. O histórico deve permitir entender por que o pedido foi liberado ou bloqueado.
- Identificador único ligando pedido, cobrança e pagamento.
- Tratamento de indisponibilidade e retentativas.
- Fila de eventos que exigem revisão humana.
- Conciliação periódica entre provedor e ERP.
Teste diferenças que afetam dinheiro
Use o ambiente de testes do provedor para simular aprovação, recusa e estorno. Confira valor bruto, taxas e valor líquido conforme o modelo de liquidação. Esses conceitos não devem ser misturados em um único campo. Na entrada em produção, execute uma validação controlada com autorização e conferência do responsável financeiro.
Considere operação e manutenção
APIs, certificados e contratos de fornecedores mudam. A integração precisa de monitoramento para identificar eventos parados e de um responsável por reprocessar falhas com segurança. Inclua manutenção e atendimento na comparação de custo, além da implantação.
Como iniciar
Informe o ERP, os meios de pagamento, o provedor e as regras de liberação. A Quantum9 pode mapear o fluxo e os critérios de conciliação. Se também há cobrança manual e baixas em planilhas, leia o guia de automação de contas a receber.