Configuração por Loja / Entidade

Cada loja precisa ter seus dados de acesso à Credsystem cadastrados no sistema, incluindo usuário, senha, Endereços Uniformes de Recurso e vínculos com o caixa.

Em linguagem simples

Antes de consultar faturas ou receber pagamentos, a equipe de Tecnologia da Informação precisa configurar cada loja no sistema. É como cadastrar o "login e senha" que a loja usa para falar com a Credsystem.

O que precisa ser preenchido:

Selecionar a loja (entidade) no menu.
Usuário e senha fornecidos pela Credsystem.
Endereços das Interfaces de Programação de Aplicações (links de conexão — a equipe de Tecnologia da Informação recebe da Credsystem).
Forma de pagamento e natureza — para o caixa registrar corretamente a entrada de dinheiro.
Imagem de fundo do totem (opcional) — personaliza a tela do autoatendimento por Pagamento Instantâneo.

A tela de configuração atual usa o módulo Interface de Programação de Aplicações Credsystem (interface Quasar). Existe uma tela antiga que foi substituída por esta.

Fluxo de configuração

Figura 4 — A configuração é salva por entidade e lida por todos os módulos que operam pagamentos.

Detalhes para Tecnologia da Informação

Armazenamento

Tabela: configuracao_entidade
Chave (descricao): api_config_credsystem
Valor: Notação de Objetos JavaScript codificado em Codificação Base 64
Métodos: getConfiguracaoCredsystem() / salvarConfiguracaoCredsystem() em 981bfb94/controle.php

Campos do Notação de Objetos JavaScript de configuração

Campo	Descrição
`idEntidade`	ID da entidade/loja
`usuario`	Usuário Credsystem
`senha`	Senha Credsystem (não expor em logs)
`urlArrecadacao`	Endereço Uniforme de Recurso base Interface de Programação de Aplicações arrecadação (legado Linguagem de Descrição de Serviços Web; Transferência Representacional de Estado usa Endereços Uniformes de Recurso fixos no código)
`urlLimite`	Endereço Uniforme de Recurso Interface de Programação de Aplicações limite/venda
`bandeira`	Bandeira do cartão (ex.: OBJETIVA)
`idFormaPagamento`	ID forma de pagamento no Ponto de Venda para receita
`idNaturezaLancamento`	Natureza contábil da receita
`idNaturezaDespesa`	Natureza contábil da despesa (estorno)

Configuração do Totem

Chave global: credsystem_pix_fundo_totem_atracao (tabela configuracao)
Endpoints: obterFundoTotemAtracao, salvarFundoTotemAtracao, limparFundoTotemAtracao, exibirFundoTotemAtracao
Armazena imagem via arquivo_imagem_model

Tela de configuração

Canônica: 981bfb94/visual.html (Quasar/Vue)
Legada (não usar): f3d67c71/visual.html (AngularJS) — mesma chave api_config_credsystem

Autenticação Credsystem (Transferência Representacional de Estado)

O módulo 981bfb94 obtém token Autorização Aberta versão 2 via Oracle IDCS (client_credentials). Endereços Uniformes de Recurso de homologação estão definidas no construtor da classe. Para produção, parametrizar Endereços Uniformes de Recurso e credenciais Autorização Aberta fora do código ou via variáveis de ambiente.