Requisitos Para o Desenvolvimento

Todos aplicativos necessários estão disponíveis no Portal do Desenvolvedor, no menu Downloads.

É obrigatório que seu aplicativo funcione em todos nossos modelos de terminais do POS.

Requisitos mandatórios¶

Suporte ao Android 7.1 (25), Android 10 (29), Android 11 (30) e ao Android 13 (33).
O desenvolvimento do aplicativo pode ser nativo ou híbrido (Exemplo: Xamarin, pois irá compilar o código para o “Android Runtime (ART)” como se fosse um aplicativo nativo).
O aplicativo deve estar utilizando o SDK de Hardware da Getnet.

Os seguintes atributos devem ser adicionados no build.gradle para que seja possível assinar seu aplicativo para o modelo de terminal TecToy Sunmi P2.

v1SigningEnabled true
v2SigningEnabled true
signingConfig signingConfigs.config

Exemplos:

android {
    //INICIO - Deve ser inserido esse metodo dentro do android{}
    signingConfigs {
        config {
            v1SigningEnabled true
            v2SigningEnabled true
        }
    }
//FIM - Deve ser inserido esse metodo dentro do android{}
    buildTypes {
        debug {
            debuggable true
            testCoverageEnabled true
            signingConfig signingConfigs.config //Deve ser inserida essa linha no buildTypes
            crunchPngs false
        }
        release {
            minifyEnabled false
            debuggable false
            signingConfig signingConfigs.config //Deve ser inserida essa linha no buildTypes
            proguardFiles getDefaultProguardFile('proguard-android.txt','proguard-rules.pro')
            crunchPngs true
        }
    }
}

O aplicativo deve possuir uma seção de "Fale Conosco" informando ao cliente os contatos necessários para atendimento em caso de problemas ou dúvidas. Essa seção deve estar bem visível e de fácil acesso.
O aplicativo deve utilizar o número de série do equipamento disponibilizado pela API da Getnet, portanto, não é permitido usar o número que o Android disponibiliza ou o número gerado pelo aplicativo, pois não será o mesmo que o da etiqueta colada no verso do aparelho.
Utilizar layout dinâmicos considerando que no futuro o aplicativo pode ser instalado em outros hardwares com resoluções e densidades diferentes.
Deve ser possível navegar por todas as telas sem o aplicativo "quebrar".
O app deve conter o metadado de queries no manifest para interagir com o SDK da Getnet. Essa informação é necessária para a comunicação entre apps em dispositivos com versão do android igual ou superior a 11 (SDK 30) como o TecToy Sunmi P3.

Exemplo:
```
    <queries>
        <package android:name="com.getnet.posdigital.service" />
    </queries>
```

Atenção: A não inserção do metadado mencionado no item 9 pode fazer com que a impressão não funcione nos terminais P3 e Gpos.

Boas práticas e segurança¶

Utilize as boas práticas de programação Android.
É de responsabilidade do desenvolvedor garantir a segurança da informação dentro do aplicativo.
Evite expor dados sensíveis dos clientes, tais como, senhas e informações pessoais.
Integridade dos dados.
Tamanho do APK – revise o seu projeto e exclua imagens e dados que não são utilizados.
Evite funcionalidades com timeout infinito que possa deixar sua aplicação travada ou aguardando algum evento.
Não manter a antena do Mifare ligada, apenas ligar quando for ser utilizada.
Uso consciente do consumo de dados.
Uso consciente do consumo de bobina de impressão – evite imagens grandes, muitos espaços em branco, deixar grandes espaços entre linhas, espaços no início e final dos comprovantes.
Uso consciente do consumo de memória e CPU.

Proibições¶

É expressamente proibido WebApps e WebView devido a medidas de segurança. Desenvolvimentos com tecnologias baseadas em Webview, são proibidas. Exemplo: Ionic, Cordova. No processo de certificação do seu aplicativo nosso time de certificação vai usar ferramentas para verificar se sua aplicação possui WebView.
O GooglePlay Services não estará disponível.
O aplicativo não pode se comunicar com nenhum concorrente direto ou indireto da Getnet ou do Grupo Santander (incluindo bancos, adquirentes, subadquirentes e wallets).
O aplicativo não pode ser executado em modo de tela cheia.
O aplicativo não pode realizar alterações nas configurações de sistema do Android (Ex: data, hora, localização, etc).
Acesso a recursos externos impróprios (USB, Google Play...).
O Ícone, logo e Nome do aplicativo não podem estar vinculado às identificações visuais dos itens abaixo:
- Getnet e seus produtos;
- Banco Santander;
- Concorrentes diretos ou indiretos da Getnet ou do grupo Santander (incluindo bancos, adquirentes, subadquirentes e wallets).

Permissões no AndroidManifest¶

As permissões abaixo não são aceitas por permitirem que o aplicativo acesse alguns recursos do Android ou recursos de hardware não permitidos pela Getnet, ou também por colocar em risco a operação de outros aplicativos. A Getnet pode adicionar outras permissões proibidas durante o processo de certificação. OBS: Caso alguma das permissões a seguir esteja em seu aplicativo, você NÃO vai conseguir realizar o upload do seu aplicativo no portal:

ACCESS_INSTANT_APPS
ACCESS_WEBVIEW
BROADCAST_STICKY
CHANGE_NETWORK_STATE
CHANGE_WIFI_STATE
DELETE_PACKAGES
DISABLE_KEYGUARD
DOWNLOAD_WITHOUT_NOTIFICATION
DUMP
INSTALL_PACKAGES
INSTALL_SHORTCUT
INTERACT_ACROSS_USERS_FULL
KILL_BACKGROUND_PROCESSES
MOUNT_UNMOUNT_FILESYSTEMS
QUERY_ALL_PACKAGES
REQUEST_DELETE_PACKAGES
REQUEST_INSTALL_PACKAGES
SET_TIME
SET_TIME_ZONE
SET_WALLPAPER
SET_WALLPAPER_HINTS
SYSTEM_ALERT_WINDOW
USB_PERMISSION
USB_SET
USE_PERIPHERAL_IO
WAKE_LOCK
WHITE_CALENDAR
WRITE_APN_SETTINGS
WRITE_OWNER_DATA
WRITE_SECURE_SETTIN
WRITE_SETTINGS

Requisições para Integradoras (TEF)¶

Seu aplicativo utiliza SDK de TEF

Se você tem interesse em usar um SDK de TEF de integradores para fazer pagamentos, tais como:

Auttar
Software Express
NCR
Linx
VBI
PayGO

É necessário adotar os seguintes requisitos:

É obrigatório o uso do SDK de Hardware Getnet.
A Integradora deve entrar em contato com o fabricante para usar versão de Biblioteca Compartilhada (BC) compatível com o firmware dos fabricantes.
A Getnet pode precisar atualizar o firmware e Kernel dos terminais e a Integradora será avisada com antecedência para fazer testes e possíveis adaptações.
Durante o processo de certificação do aplicativo, a integradora precisa estar apontando para um ambiente funcional (que não é da Getnet) e que esteja configurado para usar a chave no slot 3.
A tela de pin deverá ser implementada de acordo com o fabricante conforme capítulo “Implementação de tela pin (TEF)”.