Integração Credsystem — Introdução
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:
- Portal no computador — o operador atende o cliente no balcão.
- Totem PIX — o cliente paga sozinho na tela de autoatendimento.
- 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.
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
- 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 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 |
Cliente REST/OAuth Credsystem |
88e14c87-… |
api_integracao_credsystem_pagamento_total |
Portal, totem, PDV, 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 SOAP em v1/credsystem não é coberto neste livro.