Skip to main content

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 CPF,Cadastro de Pessoa Física, receba o pagamento (dinheiro, cartão ou PIX)Pagamento Instantâneo) 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 PIXde Pagamento Instantâneo — o cliente paga sozinho na tela de autoatendimento.
  3. AppAplicativo 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 sistemaVisã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

CPFCadastro 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.
PIXPagamento Instantâneo
Forma de pagamento instantânea pelo celular, usando QRCódigo Code.de Resposta Rápida.
Totem
Tela de autoatendimento na loja, onde o cliente paga sozinho pelo PIX.Pagamento Instantâneo.
Integrador
Banco de dados auxiliar que guarda histórico de clientes, pagamentos e avaliações do totem.
PDVPonto de Venda
Sistema de ponto de venda do ILLI. Registra entradas e saídas de dinheiro no caixa.

Detalhes para T.I.Tecnologia da Informação

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

UUIDIdentificador Universal Único Classe Função
981bfb94-… api_integracao_credsystem Cliente REST/OAuthde Transferência Representacional de Estado/Autorização Aberta Credsystem
88e14c87-… api_integracao_credsystem_pagamento_total Portal, totem, PDV,Ponto de Venda, banco integrador
857e21c5-… credsystem_gestor_configuracoes Config caixa/impressora por usuário
4ac2090b-… izap Envio WhatsApp via iZap 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 SOAPProtocolo Simples de Acesso a Objetos em v1/credsystem não é coberto neste livro.

Back to top