Introdução

Este documento descreve a integração da biblioteca CliSiTef com o sistema operacional Android. A CliSiTef provê para a aplicação cliente a interface com os serviços de meio de pagamento disponíveis no servidor SiTef. Para um completo entendimento da interação da aplicação da Automação Comercial com a CliSiTef é pré-requisito o domínio total da interface de acesso ao SiTef via DLL descrita no documento “SiTef - Interface Simplificada com a aplicação.pdf”.

A CliSiTef para Android pode ser integrada com aplicações desenvolvidas para três cenários de hardware diferentes:

  1. Smartphone/Tablet Android em conjunto com PinPad externo (dois aparelhos distintos conectados via USB ou Bluetooth). Exemplo: smartphone Samsung com pinpad PAX D200.
  2. Terminal APOS com pinpad externo fixo (um aparelho único que compreende tablet Android, pinpad externo acoplado ao tablet, impressora térmica e outros periféricos). Exemplo: Verifone Carbon 10.
  3. Terminal APOS com pinpad interno (um aparelho único que compreende smartphone Android, pinpad interno, impressora térmica e outros periféricos).Exemplos: Gertec GPOS700 e Ingenico A8.

Como todos os Cenários são Android, a forma de integração é essencialmente a mesma. Ou seja, o fluxo de chamadas à CliSiTef será praticamente idêntico nos três Cenários. As pequenas diferenças são causadas pelo fato dos Cenários 1 e 2 utilizarem um pinpad externo e o Cenário 3 utilizar um pinpad interno, que compartilha a tela com a aplicação. Por isso, é importante que os desenvolvedores no Cenário 3 leiam com atenção a Seção 7 específica para APOS com pinpad interno. Para integração nos Cenários 2 e 3, por já possuírem um pinpad interno ou acoplado externamente, os desenvolvedores podem desconsiderar os trechos deste documento referentes ao PinPad externo USB/Bluetooth (Seção 6).

No momento da publicação deste documento, diversos modelos de terminais APOS se encontram em processo de homologação com as redes adquirentes. Para esses casos, a Software Express fornece versões de CliSiTef apenas para desenvolvimento ou piloto. Consulte-nos sobre a disponibilidade para cada plataforma.