Configurando Projeto¶

Adicionando lib de Integração ao Projeto¶

Entre em <project>\app do seu projeto e crie uma pasta chamada libs. Baixe a última versão da lib payments-api-x.x.x.x.aar e copie para a pasta criada no seu projeto.

Após isso, abra o arquivo build.gradle (Module app) e adicione as seguintes dependências em destaque:

    implementation fileTree(dir: "libs", include: ["*.jar", "*.aar"])
    implementation 'org.parceler:parceler-api:1.1.12'
    annotationProcessor 'org.parceler:parceler:1.1.12'
    implementation 'com.google.code.gson:gson:2.8.5'

assets/images/add_dependencia

Permissões do Android (AndroidManifest.xml)¶

Para melhor integração com a API é importante e necessário que a aplicação que vai fazer uso da API, adicionar algumas permissões do Android.

Se for necessário alguma permissão específica do Android da fabricante, entrar em contato com a fabricante solicitando instruções.

A seguir, a lista contendo algumas permissões recomendadas.

    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    <uses-permission android:name="android.permission.RECEIVE_EXPORTED_BROADCASTS" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="com.pax.permission.PRINTER" />
    <uses-permission
        android:name="android.permission.QUERY_ALL_PACKAGES"
        tools:ignore="QueryAllPackagesPermission" />

assets/images/permissoes

Warning

No build.gradle da aplicação que está integrando, no campo buildTypes, utilizar o parâmetro isMinifyEnabled igual a false, para evitar problemas relacionados a compressão da aplicação que está utilizando a lib de pagamento.

Pronto! Seu projeto já está configurado e terá acesso às classes disponíveis na lib.
Vide Referências API.

Configurando projeto para debug¶

Se o seu aplicativo está sendo desenvolvido para rodar em terminais POS (Point Of Service), é importante que seu aplicativo seja publicado na Paystore o quanto antes, mesmo que ainda esteja no começo.

Isso é necessário para que o terminal não remova o seu aplicativo automaticamente ao identificar que o app não está presente na loja da Paystore. Por isso, não perca tempo e faça a publicação do seu app assim que possível. Veja como é simples aqui, caso necessário, entre em contato com nosso suporte.