Informações e diagnóstico da biblioteca

Operação responsável por obter informações operacionais e de configuração da biblioteca Client Conecta instalada no estabelecimento.

Por meio dessa operação, é possível consultar dados como:

Versão da biblioteca em execução;
Identificador do terminal (TerminalId) configurado;
Ambiente ativo, homologação ou produção;
Porta de comunicação utilizada pelo Pin Pad;
Estado atual de inicialização do client;
Informações relevantes para diagnóstico e validação do ambiente;
Informações detalhadas do pinpad conectado, incluindo dados de hardware, firmware, versões de kernels EMV e contactless, fabricante, modelo, capabilities e características técnicas do dispositivo.

📘
O retorno da operação passa a incluir o objeto Pinpad, que reúne informações específicas do dispositivo conectado, como número de série, modelo, fabricante, versões de firmware e bibliotecas, além de características físicas, suporte a mídias e resolução de display. Com isso, é possível obter uma visão mais completa do ambiente de captura.

Em resumo, esta operação permite consultar o estado atual de configuração e execução da biblioteca, incluindo versão, terminal configurado, ambiente ativo e parâmetros de comunicação.

Parâmetros de Entrada

Campo	Tipo	Formato	Obrigatório	Descrição
`Oper`	string	N..3	M	Código da operação: fixo "4" (`CFL_OPER_STATUS`)

Mensagem de notificação recebida na callback da operação

Não há.

Dados de resposta recebido na callback da operação

Os dados de resposta são retornados por meio da função de callback no formato JSON, conforme estrutura abaixo.

Campos retornados

Campo	Tipo	Formato	Obrigatório	Descrição
`Oper`	string	N..3	ME	Código da operação: fixo "4" (`CFL_OPER_STATUS`)
`Code`	string	N..2	M	Código de identificação do conteúdo do JSON enviado na função de callback: “0” = indica que o JSON contém os dados de resposta da operação realizada.
`TerminalId`	string	A8	M	Número do terminal cadastrado
`ConfirmationStatusSetup`	string	N1	M	Configuração da confirmação de transação: "0" confirmação não automática. A confirmação de uma transação deve ser realizada pela Automação Comercial através da operação de confirmação definida na Gestão de transação pendente; “1” = confirmação automática. A confirmação de uma transação é realizada pela biblioteca Client Conecta (default), não sendo necessária nenhuma ação da Automação Comercial.
`PortPinpad`	string	N..2	M	Porta de comunicação do Pin Pad “0” à “99”: "0" = utiliza a primeira porta disponível onde é identificada a presença de um Pin Pad; "NN" = utiliza o Pin Pad conectado na porta NN.
`Environment`	string	N1	M	Identificador do ambiente Cielo Conecta para a realização das transações, sendo: “0” = “Produção”; “1” = “Homologação”.
`Status`	string	N2	M	Status da biblioteca Client Conecta: “00” = não inicializada; “01” = inicializada, mas não operacional; “02” = inicializada e operacional.
`Version`	string	A..99	M	Versão da Biblioteca Client Conecta.

Pin Pad

Campo	Tipo	Formato	Presença	Descrição
`SerialNumber`	string	A..99	M	Número de série do Pin Pad.
`PhysicalCharacteristics`	string	A..99	M	Características físicas do dispositivo (ex.: com chip, sem SAM, contactless).
`ReturnDataInfo`	string	A..99	M	Código de retorno interno relacionado às informações do Pin Pad.
`EmvKernelVersion`	string	A..99	M	Versão do kernel EMV instalado no Pin Pad.
`ContactlessModuleVersion`	string	A..99	M	Versão do módulo de comunicação contactless.
`PayPassKernelVersion`	string	A..99	M	Versão do kernel PayPass (Mastercard), podendo incluir data de release.
`PayWaveKernelVersion`	string	A..99	M	Versão do kernel PayWave (Visa), podendo incluir data de release.
`HardwareModel`	string	A..99	M	Modelo do hardware do Pin Pad e capacidade de memória.
`Manufacturer`	string	A..99	M	Fabricante do dispositivo.
`FirmwareVersion`	string	A..99	M	Versão do firmware instalado no Pin Pad.
`BasicLibVersion`	string	A..99	M	Versão da biblioteca básica embarcada no Pin Pad.
`SpecificationVersion`	string	A..99	M	Versão da especificação técnica suportada pelo Pin Pad.
`AcquirerVersion`	string	A..99	M	Versão dos parâmetros/configurações da adquirente.
`TablesVersion`	string	A..99	M	Versão das tabelas operacionais carregadas no Pin Pad.
`LicenseExpirationDate`	string	A..99	O	Data de expiração da licença, quando aplicável. Pode vir vazio.
`SupportedMediaTypes`	string	A..99	M	Lista de tipos de mídia suportados (formatos de imagem). Exemplo: `[PNG, JPG]`.
`DisplayResolution`	string	A..99	M	Resolução da tela do dispositivo em pixels. Exemplo: `240x320` (Largura x Altura).

Retornos

Código	Descrição
`CFL_OK`	Operação realizada com sucesso.