Prerequisites

Before you integrate the SDK White Label, confirm that your development environment, credentials, and terminal meet the requirements below.

Development environment

The SDK targets a specific toolchain. Align your project with these versions:

RequirementValueNotes
JDK21The project does not compile with a different JDK. A typical sync error is Unsupported class file major version.
minSdk26 (Android 8.0)Same minimum as the SDK.
compileSdk36Same as the SDK, or higher.

Onboarding credentials

You initialize the SDK with credentials issued by Getnet:

  • clientId
  • clientSecret
  • terminalCode

Integrator application data

You also provide two values that identify your application:

  • partnerName — your company's legal or trade name.
  • partnerPackageName — the package name of your integrating application, for example com.yourcompany.app.

Terminal

You need a certified Android POS terminal available to run the payment flows. The SDK depends on hardware and services that exist only on POS devices, so it does not run on emulators, virtual machines, or ordinary Android phones.

The terminal must have two required services installed:

  • Platformcom.pagonxt.hal.platform
  • Middlewarecom.getnet.posdigital.service

Without both services, the SDK does not operate. Installing them is covered in Add the SDK to your project.

SDK material

The SDK is distributed as a local Maven repository. This delivery provides the homologation (HML) material, used by the debug build type, which covers credit, debit, voucher, and Pix in Brazilian reais.

Next steps