Visão geral
SDK SoftPOS da Eagle — aceite pagamentos por aproximação no próprio celular Android do vendedor, via m-SiTef Tap on Phone
Em construção
O SDK SoftPOS transforma o celular Android do vendedor em terminal de pagamento por aproximação. Ele não processa a transação: orquestra o m-SiTef Tap on Phone (Fiserv), que assume a tela no momento da cobrança, lê o cartão por NFC e devolve o resultado ao seu aplicativo.
O SDK existe para que o seu app não precise conhecer o protocolo do m-SiTef, nem guardar credenciais de adquirente.
Como uma venda acontece
Três decisões que moldam a integração
| Decisão | O que significa para o seu app |
|---|---|
| O m-SiTef não é embarcado | Ele é um aplicativo separado, instalado pela Play Store (exigência PCI MPoC). O seu app precisa checar a presença dele e, se faltar, mandar o usuário instalar |
| O SDK é headless | Não há telas do SDK. Ele expõe estado e resultados; a UI de cobrança, comprovante e erro é sua. Durante a leitura do cartão quem está na frente é o m-SiTef |
| Credenciais nunca ficam no app | empresaSitef, endereço do SiTef e token TLS são resolvidos a cada venda pelo backend Eagle e descartados em seguida. Nada disso vai no APK nem é persistido no aparelho |
Plataformas
| Alvo | Pacote | Situação |
|---|---|---|
| Android nativo (Kotlin/Java) | AAR com.eagleix.softpos:sdk | Suportado |
| React Native | @eagleix/softpos-react-native | Suportado (Android) |
| Flutter | eagleix_softpos | Suportado (Android) |
| iOS | — | Não existe: o m-SiTef Tap on Phone é exclusivo do Android |
Em apps híbridos, os wrappers compilam e rodam no iOS: isSupported() retorna false e
os demais métodos falham de forma tipada (UNSUPPORTED_PLATFORM). Você não precisa de
código condicional de plataforma — precisa apenas esconder a UI de cobrança quando
isSupported() for falso.
O que o SDK faz e o que não faz
Faz: checar a instalação do m-SiTef, ativar o vendedor no backend Eagle, resolver a
configuração da transação, montar e disparar a Intent, interpretar o retorno (incluindo a
tabela de CODRESP) e relatar a venda ao backend.
Não faz: desenhar telas, cancelar ou estornar transações, imprimir comprovante, rodar no iOS. Ver Limitações.
Por onde começar
Requisitos
Aparelho, m-SiTef, credenciais e o que pedir antes de integrar
Android nativo
Integração em Kotlin: inicializar, ativar vendedor e cobrar
React Native
Ponte tipada sobre o SDK nativo
Flutter
Plugin Dart sobre o SDK nativo
Referência da API
Tipos, métodos, estados e erros
Ambiente de desenvolvimento
Mock do backend e teste ponta a ponta sem credenciais reais