Integração Credsystem — Introdução

Este material explica como o sistema ILLI se conecta à Credsystem para consultar faturas, receber pagamentos e operar o Totem de Pagamento Instantâneo nas lojas.

Índice dos capítulos

01 — Introdução (esta página): o que é o sistema e palavras importantes
02 — Arquitetura: como os módulos se conectam
03 — Instalação: banco de dados e passos de instalação
04 — Configuração: cadastro por loja/entidade
05 — Portal do operador: tela de atendimento no balcão
06 — Fluxo de pagamento: pagamento em dinheiro ou cartão
07 — Fluxo de Pagamento Instantâneo e Totem: pagamento por Código de Resposta Rápida e autoatendimento
08 — Parcelamento e limite: simulação e contratação de planos
09 — Estorno e regras: desfazimento de pagamento
10 — Gestor no celular: configuração de caixa e impressora
11 — Referência para Tecnologia da Informação: endpoints, tabelas e auditoria

Em linguagem simples

O sistema permite que a loja consulte a fatura do cliente pelo Cadastro de Pessoa Física, receba o pagamento (dinheiro, cartão ou Pagamento Instantâneo) e registre tudo no caixa e no histórico da loja.

Existem três formas principais de uso:

Portal no computador — o operador atende o cliente no balcão.
Totem de Pagamento Instantâneo — o cliente paga sozinho na tela de autoatendimento.
Aplicativo Gestor no celular — configura qual caixa e impressora cada funcionário usa.

Tudo isso conversa com os servidores da Credsystem (empresa do cartão/fatura) pela internet, de forma segura.

Visão geral do sistema

Figura 1 — O ILLI fica no meio: recebe o pedido da loja, fala com a Credsystem e registra no caixa.

Glossário — palavras que você vai encontrar

Cadastro de Pessoa Física: Número de identificação do cliente. É usado para buscar a fatura dele.
Extrato / Fatura: Conta que o cliente precisa pagar. Pode ter valor total, valor mínimo ou parcelas.
Entidade / Loja: Cada unidade de negócio cadastrada no ILLI. Cada loja tem sua própria configuração.
Caixa: O ponto de venda onde o operador trabalha. O pagamento pode gerar uma entrada de dinheiro no caixa.
Pré-autorização: Passo em que a Credsystem reserva o pagamento antes de confirmar de vez. É como "segurar" o valor.
Efetivação: Confirmação final do pagamento na Credsystem.
Estorno / Desfazimento: Cancelar um pagamento que já foi feito. Só é permitido em alguns casos e dentro de um prazo.
Pagamento Instantâneo: Forma de pagamento instantânea pelo celular, usando Código de Resposta Rápida.
Totem: Tela de autoatendimento na loja, onde o cliente paga sozinho pelo Pagamento Instantâneo.
Integrador: Banco de dados auxiliar que guarda histórico de clientes, pagamentos e avaliações do totem.
Ponto de Venda: Sistema de ponto de venda do ILLI. Registra entradas e saídas de dinheiro no caixa.

Detalhes para Tecnologia da Informação

O diretório bibliotecas/ contém 4 módulos independentes escritos em Pré-processador de Hipertexto, cada um identificado por Identificador Universal Único:

Identificador Universal Único	Classe	Função
`981bfb94-…`	`api_integracao_credsystem`	Cliente de Transferência Representacional de Estado/Autorização Aberta Credsystem
`88e14c87-…`	`api_integracao_credsystem_pagamento_total`	Portal, totem, Ponto de Venda, banco integrador
`857e21c5-…`	`credsystem_gestor_configuracoes`	Config caixa/impressora por usuário
`f3d67c71-…`	`configCredsystem`	Tela legada (substituída pela Quasar em `981bfb94`)

Dependência compartilhada: util.php (12262a22-30ab-11e9-bb4c-127101af6b0d).

Documentação focada nos módulos atuais; legado Protocolo Simples de Acesso a Objetos em v1/credsystem não é coberto neste livro.