Getnet DocsGetnet Docs

Pré-requisitos

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

Antes de integrar o SDK White Label, confirme se seu ambiente de desenvolvimento, suas credenciais e seu terminal atendem aos requisitos abaixo.

Ambiente de desenvolvimento

O SDK usa uma toolchain específica. Alinhe seu projeto com estas versões:

RequisitoValorObservações
JDK21O projeto não compila com outro JDK. Um erro de sincronização típico é Unsupported class file major version.
minSdk26 (Android 8.0)Mesmo mínimo do SDK.
compileSdk36Igual ao do SDK ou superior.

Credenciais de onboarding

Você inicializa o SDK com credenciais emitidas pela Getnet:

  • clientId
  • clientSecret
  • terminalCode

Dados da aplicação integradora

Você também informa dois valores que identificam sua aplicação:

  • partnerName — a razão social ou o nome fantasia da sua empresa.
  • partnerPackageName — o nome do pacote da sua aplicação integradora, por exemplo com.yourcompany.app.

Terminal

Você precisa de um terminal POS Android homologado disponível para executar os fluxos de pagamento. O SDK depende de hardware e serviços que existem somente em dispositivos POS. Por isso, ele não roda em emuladores, máquinas virtuais ou celulares Android comuns.

O terminal precisa ter dois serviços obrigatórios instalados:

  • Platform — com.pagonxt.hal.platform
  • Middleware — com.getnet.posdigital.service

Sem os dois serviços, o SDK não funciona. A instalação deles está descrita em Adicione o SDK ao seu projeto.

Material do SDK

O SDK é distribuído como um repositório Maven local. Esta entrega fornece o material de homologação (HML), usado pelo build type debug, que cobre crédito, débito, voucher e Pix em reais.

Próximos passos