Getnet DocsGetnet Docs

Agrega el SDK a tu proyecto

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

Esta guía configura el SDK White Label en un proyecto Android: el permiso, el JDK de Gradle, los servicios requeridos en el terminal y la dependencia del SDK.

Antes de comenzar

Confirma que cumples los Requisitos previos. Esta entrega incluye el material de homologación (HML). El tipo de build debug lo usa.

Paso 1: Agrega el permiso de Android

Agrega el permiso de internet a tu AndroidManifest.xml:

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

El SDK lo usa para comunicarse con los servicios de pago.

Paso 2: Configura el JDK de Gradle en 21

El proyecto compila solo con JDK 21. En Android Studio:

  1. Abre Settings → Build, Execution, Deployment → Build Tools → Gradle.
  2. En Gradle JDK, selecciona un JDK 21 — por ejemplo, el JetBrains Runtime 21 incluido (jbr-21).
  3. Haz clic en Apply y ejecuta el Sync de Gradle otra vez.

La sincronización se completa sin el error Unsupported class file major version.

Paso 3: Instala los servicios requeridos en el terminal

El SDK depende de dos servicios instalados en el terminal, entregados como APKs en la carpeta apks/ del toolkit. Primero, verifica si ya están instalados: en el terminal, abre Settings → Apps y busca ambos, o usa adb:

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

Si ambos están presentes, pasa al Paso 4. Si no, habilita la depuración USB en el terminal, conéctalo e instala la Platform de tu fabricante más el Middleware común:

## 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"

Paso 4: Agrega el repositorio Maven

El SDK se distribuye como un repositorio Maven local. Apunta maven { url } a la carpeta hml, que resuelve el tipo de build debug. Usa una ruta absoluta.

settings.gradle.kts (Kotlin DSL):

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

Paso 5: Declara la dependencia

Declara el material HML con debugImplementation:

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

La coordenada com.pagonxt.sdk:brazil-hml:1.0.0-SNAPSHOT se resuelve desde el repositorio Maven local.

Siguientes pasos