Home

Introdução

Bibliotecas do fabricante

Os fabricantes dos terminais APOS fornecem bibliotecas adicionais para suporte do pinpad e periféricos adicionais (impressora, leitor de código de barras, etc.). A CliSiTef, em particular, depende da Biblioteca Compartilhada que provê o acesso ao pinpad, então ela precisa ser obrigatoriamente incluída no projeto. Por regra geral, é responsabilidade do fabricante (Gertec, Ingenico, Verifone, etc.) ou do fornecedor do terminal prover o suporte para essas bibliotecas. Porém, veja a seguir algumas recomendações para cada modelo.

  • Gertec GPOS700 (SDK antigo):incluir a biblioteca libppcomp.aar no classpath do projeto. Esse pacote já possui as classes de impressora, portanto a biblioteca GPOS700_750v1.0.jar não deve ser incluída junto. A inclusão das duas bibliotecas causa erro de conflito na compilação (duplicidade de classes dos pacotes wangpos.sdk4.*). É importante também se certificar com a Gertec de que o terminal possui número de série. Se não possuir, a CliSiTef indicará Erro 31 (ERRO PINPAD) ao tentar acessar o pinpad. Outra causa de erro no pinpad é a falta da aplicação FactoryService, que deve ser instalada no terminal.

  • Gertec GPOS700 (SDK atual): incluir as bibliotecas ppcomp-<versão>.aar e payment-<versão>.aar no classpath do projeto.

  • Ingenico A8:incluir a biblioteca bcapos-<versão>.aar no classpath do projeto. Essa biblioteca utiliza o framework de logging SLF4J, portanto é necessário incluir também essa biblioteca (no caso do Android Studio, incluir implementation 'org.slf4j:slf4j-api:1.7.25' no build.gradle.).

  • Verifone Carbon 10: incluir as bibliotecas DeveloperSDK-<versão>.aar e Carbon_Connection-<versão>.aar no classpath. Também é necessário instalar a aplicação PaymentService-<versão>.apk.

    A Software Express fornece esses arquivos apenas quando autorizada pelo fabricante. Caso sejam fornecidas diretamente pelo fabricante ou outro fornecedor, é importante verificar a compatibilidade da versão da CliSiTef com as versões das bibliotecas do fabricante. A combinação não homologada de versões diferentes pode causar erros na aplicação (a Software Express não garante o funcionamento correto). O arquivo VERSIONS.TXT do pacote da CliSiTef informa as versões compatíveis.