Requisitos previos
Antes de integrar el SDK White Label, confirma que cumples los requisitos que se indican a continuación. Cubren tu entorno de desarrollo, tus credenciales y tu terminal.
Entorno de desarrollo
El SDK usa una toolchain específica. Alinea tu proyecto con estas versiones:
| Requisito | Valor | Notas |
|---|---|---|
| JDK | 21 | El proyecto no compila con otro JDK. Un error de sincronización típico es Unsupported class file major version. |
minSdk | 26 (Android 8.0) | El mismo mínimo que el SDK. |
compileSdk | 36 | Igual al del SDK o superior. |
Credenciales de onboarding
Inicializas el SDK con credenciales emitidas por Getnet:
clientIdclientSecretterminalCode
Datos de la aplicación integradora
También informas dos valores que identifican tu aplicación:
partnerName— la razón social o el nombre comercial de tu empresa.partnerPackageName— el nombre del paquete de tu aplicación integradora, por ejemplocom.yourcompany.app.
Terminal
Necesitas un terminal POS Android homologado disponible para ejecutar los flujos de pago. El SDK depende de hardware y servicios que existen solo en dispositivos POS. Por eso, no funciona en emuladores, máquinas virtuales ni celulares Android comunes.
El terminal debe tener dos servicios obligatorios instalados:
- Platform —
com.pagonxt.hal.platform - Middleware —
com.getnet.posdigital.service
Sin ambos servicios, el SDK no opera. Su instalación se describe en Agrega el SDK a tu proyecto.
Material del SDK
El SDK se distribuye como un repositorio Maven local. Esta entrega proporciona el material de homologación (HML), usado por el tipo de build debug, que cubre crédito, débito, voucher y Pix en reales brasileños.
Siguientes pasos
- Agrega el SDK a tu proyecto — configura los permisos, el JDK, los servicios del terminal y la dependencia.