Getnet DocsGetnet Docs

Arquitetura e fluxo

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

O modelo de integração App2App permite uma comunicação local fluida e segura entre uma aplicação de automação de terceiros e o Getnet Payment App instalado no mesmo terminal Android.

Mecanismo de comunicação: Android Intents

A troca de dados não exige uma conexão persistente. Em vez disso, ela usa Android Intents e Deeplinks para disparar comandos e receber respostas.

  • Um Intent é um objeto de mensagem usado para solicitar uma ação de outro componente de aplicativo.

  • Deeplink é uma URI específica (por exemplo, getnet://payment/v1/payment) que funciona como o “endereço” de um recurso específico dentro do Getnet App.

Comandos suportados

Esta tabela resume as operações que sua aplicação pode solicitar ao terminal Getnet:

OperaçãoURI do deeplinkDescrição
Pagamentogetnet://payment/v1/paymentInicia uma transação de pagamento (cartão ou QR Code).
Pré-autorizaçãogetnet://payment/v1/pre-authReserva temporariamente valores no cartão de crédito do cliente.
Reembolsogetnet://payment/v1/refundReverte uma transação aprovada anteriormente.
Dados do estabelecimentogetnet://payment/v1/commerce-dataRecupera os dados cadastrais do estabelecimento.
Obter informaçõesgetnet://payment/v1/get-infoRecupera dados técnicos do terminal (S/N, OS, versão).
Pollinggetnet://payment/v1/pollingVerifica se o aplicativo de pagamento está pronto para atender requisições.
Reimpressãogetnet://payment/v1/last-transactionRetorna ou reimprime o último comprovante.
Relatóriosgetnet://payment/v1/reportsRecupera o histórico de transações (lista detalhada ou resumo de totais).
Turnogetnet://payment/v1/shiftGerencia turnos (configurar, trocar ou recuperar informações de turno).
Cancelar operaçãogetnet://payment/v1/cancel-operationCancela uma operação de deeplink em andamento.
Consultar statusgetnet://payment/v1/transaction-check-statusBusca o status de uma transação anterior específica.

O ciclo de vida da transação

O processo segue três etapas principais e garante que o controle da interface volte para a sua aplicação após a operação:

  1. Início (requisição): Sua aplicação dispara um Intent com uma URI de deeplink específica e os parâmetros de requisição enviados como extras.

  2. Processamento (fluxo de interface): O Getnet Payment App assume o controle da interface para interagir com o usuário ou processar a transação.

  3. Retorno (callback): Ao concluir, o Getnet Payment App devolve os parâmetros de resposta como extras do Intent pelo método onActivityResult.

Próximos passos