Getnet DocsGetnet Docs

Visão geral do App2App

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

Bem-vindo à documentação do App2App, a solução de integração da Getnet para terminais Android. Essa tecnologia garante uma forma fluida, segura e eficiente de processar pagamentos diretamente no hardware da Getnet.

O App2App é um modelo de integração baseado em Deeplinks e Android Intents. Ele permite que seu app de automação inicie transações financeiras enviando comandos ao Getnet Payment App.

O App2App elimina a necessidade de integrações cloud-to-cloud complexas em transações com cartão presente. Seu software se comunica localmente com o Getnet Payment App instalado no mesmo dispositivo.

Quando o processo de pagamento termina, incluindo leitura do cartão, inserção do PIN e autorização, o app da Getnet devolve automaticamente o controle e os metadados da transação para sua aplicação.

Principais vantagens e benefícios

Integrar seu software ao Getnet Payment App pelo modelo App2App traz vantagens estratégicas e técnicas. Elas otimizam a jornada de pagamento tanto para o estabelecimento quanto para o desenvolvedor. Ao usar a comunicação local, a integração garante um alto nível de segurança e eficiência operacional.

  • O software faz a transição fluida para a interface de pagamento. O operador não precisa alternar entre aplicativos manualmente.

  • Todo o processamento crítico acontece no ambiente seguro da Getnet, o que garante que sua aplicação nunca manipule dados sensíveis do cartão.

  • As transações ficam bem mais rápidas, porque a comunicação local entre apps elimina a dependência da latência de internet na troca interna de dados.

  • O envio automático dos valores elimina erros de digitação e garante precisão total durante o checkout.

  • Você pode usar a impressora integrada do terminal pelo app da Getnet ou receber os dados brutos para gerar seus próprios comprovantes personalizados.

Como funciona

O modelo de integração App2App permite a comunicação fluida entre dois aplicativos Android distintos por meio de Intents. Com esse mecanismo, seu software dispara comandos de pagamento específicos no Getnet Payment App. Os comandos são encapsulados em objetos de requisição predefinidos.

  • Requisição: seu app envia um Android Intent para uma URI específica (por exemplo, getnet://payment/v1/payment) com os dados da transação.

  • Processamento: o app da Getnet processa o comando e trata a comunicação com os servidores da adquirente para concluir a transação com segurança.

  • Resposta: o app da Getnet retorna uma resposta estruturada para sua aplicação, com o status da transação e os detalhes do comprovante.

Automação de telas

Uma das principais vantagens do modelo App2App é simplificar a interface do usuário no POS. Conforme os parâmetros que sua aplicação envia na requisição, o app da Getnet pode pular telas de entrada de dados automaticamente.

Por exemplo, se você incluir o valor da transação ou o meio de pagamento no deeplink, o terminal ignora essas etapas manuais e segue direto para a próxima fase do fluxo. Já se faltarem parâmetros obrigatórios, o app exibe as telas de digitação para completar os dados.

Próximos passos

Para começar sua integração, siga o caminho abaixo:

  • Leia Arquitetura e Fluxo para entender em profundidade a comunicação local via Android Intents e como gerenciar o ciclo de vida do app.

  • Faça uma Verificação de Conectividade (Polling) para executar o “handshake” inicial e confirmar que o serviço de pagamento está pronto antes de iniciar uma venda.

  • Siga o Guia de Início Rápido para processar sua primeira transação de teste (SALE) em minutos, com os exemplos de código que fornecemos.