Quando um cliente chega ao passo de pagamento, o módulo observa qual gateway seleciona. Para cada módulo de pagamento instalado pode definir uma regra de preços: um desconto (o total do carrinho desce) ou uma sobretaxa (o total do carrinho sobe). O ajuste aparece no resumo da encomenda, em distintivos opcionais junto aos nomes de pagamento e no registo final da encomenda.

Utilizações típicas: -2% para transferência bancária, +3% para cartão, taxa fixa COD, exceções de grupo B2B, incentivos por país. Está a definir o preço da escolha de pagamento, não a editar preços de produtos manualmente.

O separador Regras de preços é um gestor completo de regras com grelha de pré-visualização e formulário de adicionar/editar. Cada regra aponta para um módulo de pagamento e define:

•  
  Tipo de ajuste - desconto ou sobretaxa
•  
  Valor - percentagem ou valor fixo, com mín./máx. do carrinho e limite máximo de ajuste
•  
  Âmbito - moedas, países, zonas, grupos de clientes através de seletores visuais
•  
  Exclusões - produtos, categorias, fabricantes, fornecedores (autocompletar searchTool)
•  
  Etiqueta multilingue no checkout mostrada junto aos totais e nos distintivos de pagamento

Os descontos são aplicados como regras de carrinho nativas do PrestaShop criadas em tempo real. Cada carrinho recebe um código imprevisível PDF-* armazenado no estado do módulo. As regras ficam ligadas ao cliente autenticado quando aplicável, protegidas contra reutilização manual e eliminadas quando o cliente muda de método de pagamento ou conclui a encomenda.

O registo de auditoria regista cada criação e eliminação de regra de carrinho com ator, ID do carrinho e motivo de limpeza (mudança de pagamento, cron, sincronização pós-encomenda). A sua lista Catálogo > Regras de carrinho mantém-se limpa.

As sobretaxas usam um produto de taxa oculto dedicado configurado em Definições. Durante o checkout o valor é armazenado no estado de carrinho do módulo e mostrado como linha de subtotal sem alterar a composição do carrinho. Quando o cliente coloca a encomenda, o produto de taxa é materializado com a regra fiscal e o valor corretos.

Os hooks de cálculo de preço bloqueiam a linha de taxa ao valor de sobretaxa calculado para que os totais PrestaShop se mantenham consistentes. Eventos de aplicação e remoção de sobretaxa são escritos no registo de auditoria com ator cliente ou sistema.

•  
  Interruptores globais

  Ativar módulo, atualização do total em tempo real, distintivos de pagamento e aviso legal opcional no passo de pagamento.
•  
  Seletor de produto de taxa de sobretaxa

  Campo HelperForm padrão para selecionar ou criar automaticamente o produto de taxa oculto usado para sobretaxas.
•  
  JS de checkout compatível com temas

  Funciona com temas de checkout clássicos e modernos. Seletores CSS configuráveis para atualização do total do carrinho quando necessário.

O separador Painel mostra cartões KPI de sobretaxas, descontos e impacto líquido num período selecionável. Gráficos Chart.js cobrem tendências semanais, mensais e anuais. Tabelas detalham totais por mês e principais módulos de pagamento. Exporte dados ao nível da encomenda para CSV para contabilidade.

O separador Registo de auditoria (controlador de administração dedicado) é só de leitura e com código de cores: encomendas, CRUD de regras, alterações de definições, ciclo de vida de regras de carrinho, eventos de sobretaxa. Etiquetas de ator identificam cliente, colaborador, sistema ou cron. Cada decisão de preços deixa um rasto.

O separador Limpeza por cron explica porque aparecem regras de carrinho órfãs, fornece um URL secreto com botão de regenerar e documenta a configuração para cPanel, DirectAdmin, Plesk, SSH e serviços de cron externos. A manutenção elimina automaticamente regras PDF-* obsoletas e estados de carrinho inativos.

Em cada encomenda o módulo armazena paydisorfee_amount, tipo e ID da regra na linha da encomenda, valida que o pagamento colocado corresponde ao ajuste aplicado, regista o evento e depois limpa o estado do carrinho. Um hook na página de encomenda do back-office mostra o resumo do ajuste para a equipa de suporte.