Getnet DocsGetnet Docs

Comunicação Baseada em Intent

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

Esta página explica como a integração Get Mini App2App usa Intents do Android para permitir a comunicação entre o seu aplicativo e o aplicativo Get Mini.

O que são Intents do Android?

Intents do Android são objetos de mensagens usados para solicitar uma ação de outro componente de aplicativo. Na integração Get Mini App2App, Intents servem como o principal mecanismo de comunicação entre o seu aplicativo e o aplicativo Get Mini.

Como Funciona

A comunicação entre o seu aplicativo e o aplicativo Get Mini segue um padrão simples de solicitação-resposta. O seu aplicativo cria um Intent com uma string de ação específica e os parâmetros necessários, e então o inicia usando as APIs de resultado de atividade (activity result) do Android. O sistema Android direciona o Intent para o aplicativo Get Mini, que processa a transação e retorna o controle para o seu aplicativo com os dados do resultado.

Ações e Parâmetros do Intent

A integração Get Mini usa três ações distintas de Intent: uma para pagamentos (es.redsys.paysys.mPOSRedsys_PAYMENT_REQUEST), uma para consultas (es.redsys.paysys.mPOSRedsys_QUERY_REQUEST) e uma para estornos (es.redsys.paysys.mPOSRedsys_REFUND_REQUEST). Cada ação exige parâmetros específicos passados como extras do Intent, como valores de transação, intervalos de datas ou detalhes de autorização de transações anteriores.

Para obter especificações completas de todas as ações e parâmetros do Intent, consulte a página de referência Parâmetros de solicitação.

Tratamento de Respostas

Após o aplicativo Get Mini concluir a transação, ele retorna o controle para o seu aplicativo com um código de resultado e extras do Intent. O código de resultado indica sucesso (RESULT_OK) ou falha (RESULT_CANCELED), enquanto os extras contêm informações detalhadas da transação, incluindo números de autorização, mensagens de erro e referências de recibos.

Tratamento de Erros

Se o aplicativo Get Mini não estiver instalado no dispositivo, a tentativa de iniciar o Intent lançará uma ActivityNotFoundException. O seu aplicativo deve capturar essa exceção e orientar o usuário a instalar o aplicativo a partir da Google Play Store. Sempre use blocos try-catch ao iniciar Intents e analise todos os extras de resposta mesmo quando as transações falharem, pois eles contêm informações valiosas sobre o erro.

Para obter orientações sobre como lidar com a disponibilidade do aplicativo, consulte Gerenciar a disponibilidade do aplicativo.