Arquitetura e funcionamento

Confira a seguir, a definição para os requisitos técnicos e operacionais mínimos para facilitar o processo de integração da biblioteca Client Conecta — DLL (Windows) ou SO (Linux) — pelo sistema de pagamento, garantindo compatibilidade, segurança e desempenho. Os requisitos são apresentados separadamente para cada sistema operacional suportado, sempre que houver diferença entre eles.

Componentes da solução

Os principais componentes envolvidos são:

• Automação Comercial;
• Biblioteca Client Conecta;
• Plataforma Cielo Conecta.

Arquitetura da solução

A imagem abaixo apresenta uma visão geral dos componentes envolvidos e suas interações no fluxo de pagamento:

A imagem representa uma visão conceitual da solução. Componentes internos da biblioteca não exigem implementação por parte da aplicação integradora.

Papel do Client Conecta

A biblioteca Client Conecta atua como um client TEF, sendo responsável pela integração entre:

• O software de automação comercial;
• A plataforma de pagamentos Cielo Conecta;
• Os dispositivos de captura de dados do cartão EMV/NFC (PINPAD).

A biblioteca abstrai as complexidades operacionais e fornece uma interface padronizada para execução das transações.

Principais responsabilidades

• Disponibilizar uma interface de integração para a Automação Comercial;
• Gerenciar a comunicação com o ambiente Cielo Conecta, responsável pelo processamento e autorização;

Os detalhes do protocolo e da infraestrutura de comunicação com o Cielo Conecta não fazem parte do escopo desta documentação.

• Gerenciar a comunicação com o PINPAD para captura e validação dos dados transacionais.

A comunicação com o PINPAD ocorre por meio físico (UART/USB), utilizando o protocolo ABECS, não sendo detalhada neste documento.

Fluxo de interação

O fluxo operacional envolve a troca de informações entre a aplicação de automação comercial e a biblioteca Client Conecta, por meio de:

• Requisições enviadas à API da biblioteca (DLL no Windows / SO no Linux);
• Respostas retornadas via mecanismo de callback.

Esse modelo segue um comportamento assíncrono, permitindo o controle do ciclo de vida da transação.

Inicialização da biblioteca

Sempre que o Client Conecta é instanciado, a primeira operação obrigatória é a chamada:

Initialize

Essa operação é responsável por:

• Configurar a biblioteca;
• Preparar o ambiente para a execução das operações;
• Habilitar as operações disponíveis como: pagamento, estorno (refund), reimpressão de comprovantes, entre outras operações.