Conciliação de pagamentos: como investigar diferenças entre gateway e sistema
Um roteiro para comparar títulos, identificadores e retornos de pagamento sem criar novas cobranças ou baixas inconsistentes no provedor.
Por Equipe App Ora · Publicado em

Identifique a mesma cobrança nos dois lados
Comece pelo identificador externo do título, não apenas pelo nome ou pelo valor. Um cliente pode ter várias parcelas iguais. Confira competência, vencimento e conta do gateway. Essa relação permite verificar se a integração está atualizando a fatura correta ou se a equipe está comparando registros diferentes.
Separe os momentos do processo
Emissão, pagamento e confirmação ao sistema acontecem em momentos distintos. Consulte os registros do gateway e a situação apresentada no App Ora. Uma divergência precisa ser investigada com essa sequência em mente; criar outro título ou alterar a baixa imediatamente pode esconder a causa e gerar uma segunda inconsistência.

Confira a configuração da integração
As notificações precisam chegar à rota e à operadora correspondentes. Ao trocar credenciais ou migrar a aplicação, revise o endereço configurado no fornecedor. Evite compartilhar tokens entre operações diferentes. Uma integração deve permitir identificar quem recebeu o evento e a qual cobrança ele se refere.
Trate a exceção com registro
Quando uma correção manual for necessária, registre o motivo e mantenha a referência do pagamento. Não substitua a conferência por um comprovante isolado ou por uma anotação fora do sistema. A equipe que atender o cliente depois precisa entender o que foi ajustado e por qual razão.
Valide o fluxo após corrigir
Depois de ajustar a integração, acompanhe uma cobrança controlada até a atualização final. Confira também se o cliente encontra a situação correta no app. O objetivo é recuperar um processo confiável, e não apenas fazer um contador do painel mudar sem correspondência com os registros financeiros.