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.
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.
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.