Visão geral
Nesta aba você encontrará todas as informações necessárias para aproveitar ao máximo o SDK Getnet ao desenvolver seu aplicativo.
Disponibilizamos um conjunto de métodos que simplificam o processo de desenvolvimento, permitindo que você integre com nossos equipamentos Get Smart.
Configurando SDK¶
O SDK Getnet é uma camada de abstração entre o app e o hardware disponibilizado através de serviços dentro do Android. A utilização dele é obrigatória, pois isso garante que o aplicativo irá funcionar em todos os modelos de POS Digital da Getnet. Para baixar os arquivos necessários acesse o Portal do Desenvolvedor | Get Store, e entre no menu Downloads.
O SDK é composto por 3 arquivos. Sendo obrigatória a utilização de: serviceposdigital-(version)-release.apk, libposdigital-(version)-release.aar + service do fabricante, de acordo com o modelo de terminal.
- serviceposdigital-(version)-release.apk: é o serviço do SDK que fica rodando no terminal que se comunica com os recursos de hardware. No Portal do Desenvolvedor, está com o nome SDK de Hardware (Aplicativo). A parte do texto “(version)” é onde se encontra o version name e version code do arquivo.
- libposdigital-(version)-release.aar: é a interface do SDK que deve ser compilado com o seu app para se comunicar com o serviço. No Portal do Desenvolvedor, está com o nome SDK de Hardware (Aplicativo). A parte do texto “(version)” é onde se encontra o version name e version code do arquivo.
- GetnetService-TectoySunmiP2-(version)-release.apk: (exclusivo para o modelo TecToy Sunmi P2) é um serviço complementar do SDK, que funciona como interface para o modelo TecToy Sunmi P2, este fica rodando no terminal e se comunica com os recursos de hardware do P2. No Portal do Desenvolvedor, está com o nome SDK de Hardware (Aplicativo). A parte do texto “(version)” é onde se encontra a versão do arquivo.
- GetnetService-TectoySunmiP3-(version)-release.apk: (exclusivo para o modelo TecToy Sunmi P3) é um serviço complementar do SDK, que funciona como interface para o modelo TecToy Sunmi P3, este fica rodando no terminal e se comunica com os recursos de hardware do P3. No Portal do Desenvolvedor, está com o nome SDK de Hardware (Aplicativo). A parte do texto “(version)” é onde se encontra a versão do arquivo.
- GetnetService-Gertec-(version).apk: (exclusivo para o modelo Gertec Gpos 790s) É um serviço complementar do SDK, que funciona como interface para o modelo Gpos 790s.
É utilizado para se comunicar com os recursos de hardware dos terminais Gertec. No portal do desenvolvedor você o encontrará um arquivo .apk dentro da pasta "Somente para modelos Gertec".
Baixe os arquivos e configure corretamente para utilizar todas as funcionalidades do SDK Getnet em seu aplicativo.
Você também encontrará em Downloads outros 2 arquivos importantes:
-
devkit-(version)-release.apk: É um aplicativo de ajuda que acessa os serviços e tem alguns exemplos. Com ele, o desenvolvedor consegue validar se os serviços de hardware estão funcionando corretamente. No Portal do Desenvolvedor, está com o nome Devkit. A parte do texto “(version)” é onde se encontra o version name e version code do arquivo.
-
Rebatedor-(version)-(plataforma)-release.apk: É um aplicativo simulador da aplicação de pagamento da Getnet. Ele simula as requisições/respostas da aplicação de pagamento, o objetivo é proporcionar para o desenvolvedor um ambiente o mais próximo possível do app Pagamento. Este simulador não irá realizar as transações online com cartões, todas as funcionalidades são offline - simuladas. No Portal do Desenvolvedor, está com o nome Rebatedor. A parte “(plataforma)” é onde se encontra a arquitetura do processador (Exemplo: universal, x86 ou armeabi-v7a).
IMPORTANTE
A Getnet se reserva ao direito de solicitar ao desenvolvedor que adapte o seu aplicativo quando houver alguma mudança no SDK. Métodos deprecados serão mantidos somente durante uma versão.
Abaixo estão os serviços disponíveis e como eles estão em cada hardware.
| Serviço | TecToy Sunmi P2 | Ingenico DX8000 | TecToy Sunmi P3 | GPOS 790s |
|---|---|---|---|---|
| Card | Suporta | Suporta | Suporta | Suporta |
| Printer | Suporta | Suporta | Suporta | Suporta |
| Mifare | Suporta | Suporta | Suporta | Suporta |
| Leds | Suporta | Suporta | Suporta | Suporta |
| Beeper | Suporta | Suporta | Suporta | Suporta |
| Câmera (Leitor) de barcode e QRcode | Suporta | Suporta | Suporta | Suporta |