Pagamentos

Maquininha, TEF e Pix, com o mesmo cuidado em cada fluxo.

O sistema só considera um pagamento confirmado quando o provedor confirma. Clique na tela não é pagamento, e QR Code exibido não é Pix recebido.

Os fluxos

Os passos marcados como planejados ainda não estão implementados. Os demais já funcionam em simulação, sem cobrança real.

Cartão integrado

  1. CaixaEscolhe cartão e parcelasO pedido leva uma chave de idempotência.
  2. APIValida permissão e duplicidadeRepetir o pedido devolve o mesmo pagamento.
  3. Banco de dadosGrava a tentativa antes de cobrarNenhuma transação fica aberta na chamada externa.
  4. TerminalCaptura e autorizaVoltam só identificadores, nunca dados do cartão.
  5. Banco de dadosRegistra o resultadoCada mudança de estado fica no histórico.
  6. CaixaConclui a venda uma única vezBaixa o estoque e gera o recebível.

Pix por API

  1. CaixaEscolhe PixCom valor, loja e referência.
  2. APICria a cobrança no provedorCom identificador único e expiração.
  3. ProvedorDevolve QR Code e copia e colaO pagamento segue em processamento.
  4. ProvedorAvisa por webhook assinadoEventos repetidos são ignorados com segurança.
  5. APIConfirma consultando o provedorDecide entre aprovado e expirado.

Resposta perdida

  1. TerminalAutoriza o pagamentoO valor já foi reservado no cartão.
  2. APINão recebe a respostaQueda de rede ou navegador fechado.
  3. Banco de dadosMarca em conciliaçãoUm índice único bloqueia outra cobrança.
  4. APIConsulta o provedorPela chave da tentativa.
  5. Banco de dadosResolve com o resultado confirmadoSó "sem cobrança" libera nova tentativa.

Modalidades previstas

ModalidadeComo funcionaDepende de
SmartPOSAplicativo Android no próprio terminal, usando o SDK do fabricante.Modelo, credenciamento e homologação
PDV Windows + TEFServiço local conversa com o middleware TEF e o pinpad.Fornecedor TEF, contrato e certificação
Maquininha por SDKConector local usa o SDK por Bluetooth ou rede.Modelos suportados e permissão comercial
Pix por APIO backend cria a cobrança e acompanha a confirmação.PSP, credenciais e certificados
Link de pagamentoO backend gera o link e acompanha a confirmação.API do provedor
Pagamento manualO operador confirma um pagamento externo, com permissão.Sem confirmação automática; maior risco

Provedores

Avaliar não é o mesmo que estar integrado. Uma integração só passa a constar como disponível depois de homologada.

PagBank

Em avaliação

Stone

Em avaliação

Cielo

Em avaliação

Rede

Em avaliação

Getnet

Em avaliação

Nenhuma integração com adquirente está homologada hoje. Os fluxos acima funcionam em simulador, sem cobrança real.

Segurança dos dados de pagamento

O sistema é desenhado para que dados sensíveis de cartão nunca passem por ele.

  • Sem PAN completo, CVV, PIN ou trilhas armazenados
  • O navegador não acessa SDK, segredos ou dispositivos diretamente
  • Credenciais de provedores em cofre, nunca exibidas após o cadastro
  • Toda tentativa de pagamento fica no histórico e na auditoria