Getnet DocsGetnet Docs

Operações de Consulta

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

Este guia orienta você na recuperação do histórico de transações usando a integração Get Mini App2App. Você aprenderá como consultar operações dentro de um intervalo de datas específico para fins de relatórios e conciliação.

Requisitos

Antes de seguir os passos, certifique-se de ter:

  • O aplicativo Get Mini instalado no dispositivo Android
  • Um dispositivo PIN pad compatível emparelhado e conectado
  • O ActivityResultLauncher devidamente registrado em sua Activity ou Fragment

As operações de consulta são úteis para relatórios de fim de dia, conciliação de turnos e pesquisas de transações.

Processo de Consulta

Esta seção orienta você na criação de um Intent de consulta com um intervalo de datas. O aplicativo Get Mini recuperará todas as transações processadas dentro do período especificado e as retornará como um relatório formatado.

Passo 1: Criar o Intent de Consulta

Crie um Intent com a ação es.redsys.paysys.mPOSRedsys_QUERY_REQUEST e especifique o intervalo de datas para a sua consulta. Ambas as datas devem ser fornecidas no formato AAAAMMDD.

A tabela abaixo lista os campos obrigatórios:

ParâmetroTipoObrigatórioDescrição
dateFromStringSimData de início para o intervalo da consulta (formato AAAAMMDD).
dateUntilStringSimData de término para o intervalo da consulta (formato AAAAMMDD).

Certifique-se de que ambas as datas usem a formatação AAAAMMDD consistente (por exemplo, 20240101 para 1º de janeiro de 2024).

O código a seguir mostra como criar e iniciar o Intent de consulta:

// Create the Intent
Intent intent = new Intent("es.redsys.paysys.mPOSRedsys_QUERY_REQUEST");

// Add date range parameters
intent.putExtra("dateFrom", "20240101");
intent.putExtra("dateUntil", "20240131");

// Launch the Get Mini app
queryLauncher.launch(intent);

Passo 2: Lidar com o Resultado da Consulta

Após recuperar os dados da transação, o aplicativo Get Mini retorna o controle para o seu aplicativo com o resultado. A resposta inclui um documento de recibo contendo o histórico de transações para o período especificado.

Para obter detalhes completos sobre o tratamento de respostas, consulte Lidar com os resultados da transação.

Próximos Passos

Agora que você recuperou o histórico de transações, você pode explorar os recursos relacionados: