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:
- Smartphone/Tablet Android em conjunto com PinPad externo
(dois aparelhos distintos conectados via USB ou Bluetooth)
. Exemplo: smartphone Samsung com pinpad PAX D200. - 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. - 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.