Fluxo de Pagamento — Dinheiro e Cartão

Quando o cliente paga a fatura em dinheiro ou cartão no balcão, o sistema passa por quatro etapas na Credsystem antes de registrar o valor no caixa.

Em linguagem simples

O pagamento no balcão funciona assim:

Buscar a fatura — o sistema consulta na Credsystem o que o cliente deve.
Reservar o valor (pré-autorização) — a Credsystem "segura" o valor antes de confirmar.
Confirmar o pagamento (efetivação) — a Credsystem registra que o dinheiro foi recebido.
Verificar se deu certo (sonda) — o sistema confere se a Credsystem confirmou tudo.
Registrar no caixa — o valor entra como receita no Ponto de Venda da loja.
Guardar no histórico — fica salvo no banco integrador para consultas futuras.

Se algo der errado no meio do caminho, o sistema pode tentar estornar automaticamente a reserva (quando configurado).

Fluxo de pagamento convencional

Figura 6 — Fluxo completo do pagamento convencional: quatro etapas na Credsystem, depois gravação local e lançamento no Ponto de Venda.

A interface front-end chama pagamentoTotal() em 88e14c87/controle.php
Que delega para api_integracao_credsystem::pagamento() em 981bfb94/controle.php

#	Etapa	Endpoint de Transferência Representacional de Estado	Campo etapa em erro
1	Consultar títulos	`GET consulta-titulo`	`consultarTitulos`
2	Pré-autorização	`POST pre-autorizacao`	`preAutorizar`
3	Efetivação	`POST efetivacao`	`efetivar`
4	Sonda efetivação	`GET efetivacao/sonda`	`sondaEfetivacao`

salvarCredsystemPagamento() → INSERT em cred_pagamento (tipo DINHEIRO, situação EFETIVADO)
registrarControleAcaoPagamentoCredsystem() → log tipo credsystem-recebimento-pagamento
registraPagamento() → registrarReceita() → vendarapida::sangriasuprimento (RECEITA)

valorPagamento — valor efetivo (mínimo, parcela ou total)
estornarEmFalha — default true; chama desfazer se efetivação falhar após pré-autorização
idFormaPagamento e idNaturezaLancamento — da configuração da entidade