Integração Credsystem — Introdução

Este material explica como o sistema ILLI se conecta à Credsystem para consultar faturas, receber pagamentos e operar o Totem PIX nas lojas.

##

Em linguagem simples

O sistema permite que a loja consulte a fatura do cliente pelo CPF, receba o pagamento (dinheiro, cartão ou PIX) e registre tudo no caixa e no histórico da loja.

Existem três formas principais de uso:

1. Portal no computador — o operador atende o cliente no balcão.
2. Totem PIX — o cliente paga sozinho na tela de autoatendimento.
3. App 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.

Cliente / Operador Sistema ILLI (bibliotecas) Credsystem (na internet) Caixa / PDV (receita) Totem PIX App Gestor

##

Glossário — palavras que você vai encontrar

CPF 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*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. PIX Forma de pagamento instantânea pelo celular, usando QR Code. Totem Tela de autoatendimento na loja, onde o cliente paga sozinho pelo PIX. Integrador Banco de dados auxiliar que guarda histórico de clientes, pagamentos e avaliações do totem. PDV Sistema de ponto de venda do ILLI. Registra entradas e saídas de dinheiro no caixa.

##

Detalhes para T.I.

O diretório bibliotecas/ contém 5 módulos PHP independentes, cada um identificado por UUID:

UUID Classe Função `981bfb94-…` api_integracao_credsystem`api_integracao_credsystem` Cliente REST/OAuth Credsystem `88e14c87-…` api_integracao_credsystem_pagamento_total`api_integracao_credsystem_pagamento_total` Portal, totem, PDV, banco integrador `857e21c5-…` credsystem_gestor_configuracoes`credsystem_gestor_configuracoes` Config caixa/impressora por usuário `4ac2090b-…` izap`izap` Envio WhatsApp via iZap `f3d67c71-…` configCredsystem`configCredsystem` Tela legada (substituída pela Quasar em 981bfb94`981bfb94`)

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

Documentação focada nos módulos atuais; legado SOAP em v1/credsystem não é coberto neste livro.