Estorno e Regras de Desfazimento

Em alguns casos, o operador pode cancelar um pagamento já feito — mas existem regras de prazo e tipo de pagamento que precisam ser respeitadas.

Em linguagem simples

Se o operador cometeu um erro ou o cliente desistiu, é possível desfazer o pagamento — mas com estas regras:

Regra	Explicação
Prazo de 24 horas	Só dá para desfazer pagamentos feitos nas últimas 24 horas.
Pagamento Instantâneo não pode	Pagamentos feitos por Pagamento Instantâneo não aparecem na lista de desfazimento.
Só pagamentos confirmados	Apenas pagamentos com situação "efetivado" (confirmado).
Registra saída no caixa	O estorno gera uma despesa no Ponto de Venda (dinheiro "sai" do caixa).

Passos para o operador:

Consultar o Cadastro de Pessoa Física do cliente.
Abrir a lista de pagamentos que podem ser desfeitos.
Escolher o pagamento e confirmar o desfazimento.
O sistema cancela na Credsystem e registra a despesa no caixa.

Fluxo de estorno

Figura 9 — Estorno: lista filtrada → desfazimento na Credsystem → atualização local → despesa no Ponto de Venda.

Detalhes para Tecnologia da Informação

Constante de prazo

PRAZO_DESFAZIMENTO_HORAS = 24 em 88e14c87/controle.php

Query de listagem (listarPagamentosCredsystemIntegrador)

situacao = 'EFETIVADO'
pagamento <> 'PIX'
data_criacao >= NOW() - 24 HOURS
Limite: 2000 registros por Cadastro de Pessoa Física

desfazerPagamento()

Valida prazo e existência do registro em cred_pagamento
Chama api_integracao_credsystem::desfazer() → desfazimento
Atualiza cred_pagamento.situacao para ESTORNADO
registrarDespesa() → vendarapida::sangriasuprimento (DESPESA, usa idNaturezaDespesa)
Auditoria: credsystem-estorno-pagamento

Estorno automático em falha

No fluxo pagamento() (981bfb94), se estornarEmFalha=true (default) e a efetivação falhar após pré-autorização, o sistema chama desfazer automaticamente.