README ConnectTEF | Índice da Seção | Anterior | Próximo —
Caminho: Início / Integrações / Integracao via Intent
A integração via Intent é um dos modelos nativos de comunicação suportados pelo ConnectTEF para aplicações Android executadas em dispositivos SmartPOS.
Nesse modelo, a aplicação comercial inicia uma operação enviando um Intent para o ConnectTEF. A plataforma assume o controle da operação, executa o fluxo solicitado e devolve o resultado à aplicação chamadora.
Essa abordagem é extremamente simples de implementar e segue os padrões oficiais de comunicação entre aplicações Android.
Apresentar o funcionamento da integração via Intent, seus benefícios e os cenários recomendados para utilização em aplicações Android e SmartPOS.
A aplicação comercial inicia uma operação enviando um Intent para o ConnectTEF.
O ConnectTEF recebe a solicitação, executa toda a comunicação necessária com o SmartPOS e retorna o resultado ao aplicativo de origem.
Aplicação Android
│
│ Intent
▼
ConnectTEF
│
├── SmartPOS
├── Adquirentes
└── Serviços da Plataforma
│
▼
Resultado da Operação
Toda a complexidade operacional permanece encapsulada dentro da plataforma.
A integração via Intent é indicada para:
O desenvolvedor apenas inicia uma operação através de um Intent.
Todo o processamento da transação é realizado pelo ConnectTEF.
Utiliza um mecanismo oficialmente suportado pelo Android para comunicação entre aplicações.
Não há necessidade de protocolos proprietários.
A aplicação permanece independente da implementação interna da plataforma.
Alterações futuras no ConnectTEF normalmente não exigem modificações significativas na aplicação integrada.
Novas funcionalidades podem ser incorporadas ao ConnectTEF sem alterar a arquitetura da aplicação comercial.
Isso reduz custos de manutenção e facilita futuras evoluções.
A integração via Intent pode ser utilizada para executar diversas operações da plataforma, como:
Os recursos disponíveis evoluem continuamente conforme novas versões da plataforma são disponibilizadas.
O fluxo permanece totalmente encapsulado dentro do Android.
Aplicação Comercial
│
▼
Intent Android
│
▼
ConnectTEF
│
▼
Core da Plataforma
│
▼
SmartPOS / Adquirentes
Essa arquitetura simplifica a integração e reduz a necessidade de componentes intermediários.
A integração via Intent é recomendada quando:
O ConnectTEF suporta ambos os mecanismos nativos do Android.
| Provider | Intent |
|---|---|
| Compartilhamento estruturado de dados e serviços | Execução direta de operações |
| Comunicação contínua entre aplicações | Comunicação orientada a ações |
| Ideal para integrações mais complexas | Ideal para operações rápidas e objetivas |
| Utiliza Content Provider | Utiliza Intents do Android |
Ambos utilizam recursos nativos da plataforma Android e podem coexistir na mesma aplicação, permitindo que cada projeto utilize o modelo mais adequado às suas necessidades.
| Tecnologia | Ambiente |
|---|---|
| REST API | Web, Desktop e Cloud |
| REST API Local | Desktop e Rede Local |
| Provider | Android / SmartPOS |
| Intent | Android / SmartPOS |
| Windows DLL | Windows Desktop |
| INTPOS | Sistemas Legados |
Cada tecnologia atende um perfil específico de aplicação e arquitetura.
O próximo capítulo apresenta a integração utilizando Windows DLL, destinada principalmente a aplicações Desktop e sistemas legados executados em ambiente Windows.