Getnet DocsGetnet Docs

Adicione o SDK ao seu projeto

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Este guia configura o SDK White Label em um projeto Android: a permissão, o Gradle JDK, os serviços obrigatórios do terminal e a dependência do SDK.

Antes de começar

Confirme que você atende aos Pré-requisitos. Esta entrega fornece o material de homologação (HML), usado pelo build type debug.

Passo 1: Adicione a permissão do Android

Adicione a permissão de internet ao seu AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />

O SDK usa essa permissão para se comunicar com os serviços de pagamento.

Passo 2: Defina o Gradle JDK como 21

O projeto compila somente com o JDK 21. No Android Studio:

  1. Abra Settings → Build, Execution, Deployment → Build Tools → Gradle.
  2. Em Gradle JDK, selecione um JDK 21 — por exemplo, o JetBrains Runtime 21 que vem embutido (jbr-21).
  3. Clique em Apply e execute o Sync do Gradle novamente.

O sync é concluído sem o erro Unsupported class file major version.

Passo 3: Instale os serviços obrigatórios do terminal

O SDK depende de dois serviços instalados no terminal, entregues como APKs na pasta apks/ do toolkit. Primeiro, verifique se eles já estão instalados: no terminal, abra Settings → Apps e procure pelos dois, ou use o adb:

adb shell pm list packages | Select-String "com.pagonxt.hal.platform|com.getnet.posdigital.service"

Se os dois estiverem presentes, vá para o Passo 4. Caso contrário, ative a depuração USB no terminal e conecte-o. Depois, instale a Platform do seu fabricante e o Middleware comum:

## Platform — choose the APK for your terminal's manufacturer
adb install "apks\gertec\gertec-platform-1.1.4-release.apk"
adb install "apks\positivo\positivo-platform-1.0.59-release.apk"

## Middleware — common to all terminals
adb install "apks\common\middleware-4.0.0-release.apk"

Passo 4: Adicione o repositório Maven

O SDK é distribuído como um repositório Maven local. Aponte maven { url } para a pasta hml, que o build type debug resolve. Use um caminho absoluto.

settings.gradle.kts (Kotlin DSL):

dependencyResolutionManagement {
    repositories {
        // ...
        maven { url = uri(".../apolo-sdk/hml") } // used by the debug build type
    }
}

Passo 5: Declare a dependência

Declare o material HML com debugImplementation:

dependencies {
    // ...
    debugImplementation("com.pagonxt.sdk:brazil-hml:1.0.0-SNAPSHOT") // debug → HML
}

A coordenada com.pagonxt.sdk:brazil-hml:1.0.0-SNAPSHOT é resolvida a partir do repositório Maven local.

Próximos passos