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).
Figura 6 — Fluxo completo do pagamento convencional: quatro etapas na Credsystem, depois gravação local e lançamento no Ponto de Venda.
Detalhes para Tecnologia da Informação
Orquestração
A interface front-end chama 
pagamentoTotal() em 
88e14c87/controle.php
Que delega para 
api_integracao_credsystem::pagamento() em 
981bfb94/controle.php
Etapas na Interface de Programação de Aplicações Credsystem (método pagamento)
#
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
Pós-sucesso em 88e14c87
salvarCredsystemPagamento() → INSERT em 
cred_pagamento (tipo 
DINHEIRO, situação 
EFETIVADO)
registrarControleAcaoPagamentoCredsystem() → log tipo 
credsystem-recebimento-pagamento
registraPagamento() → 
registrarReceita() → 
vendarapida::sangriasuprimento (RECEITA)
Parâmetros relevantes
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