Integração
Como invocar o m-Sitef e o fluxo transacional do Tap-on-Phone
O m-Sitef ToP funciona como um componente cliente: o seu aplicativo (a automação do lojista) chama o m-Sitef via Android Intent, passando os parâmetros da transação, e recebe o resultado de volta quando o pagamento é concluído.
Pré-requisitos
- Dispositivo Android 12+ com NFC habilitado.
- Aplicação m-Sitef instalada e provisionada (via Google Play — ver Distribuição e permissões).
- Parâmetros de loja (empresa e endereço SiTef, documento do estabelecimento) fornecidos no onboarding.
- TLS Fiserv configurado.
Fluxo transacional
- Início — o app da automação monta os parâmetros obrigatórios (empresa SiTef, endereço SiTef, CPF/CNPJ, modalidade e valor) e invoca o m-Sitef via Android Intent.
- Atestação (PCI MPoC) — antes de capturar, o m-Sitef conecta-se ao ToP Gateway para atestação e monitoramento de segurança. Em caso de falha, a transação é interrompida e nada é capturado.
- Captura NFC — o operador aproxima o cartão, carteira digital ou wearable do celular. O m-Sitef lê os dados por contactless.
- Autorização — a transação é roteada pelo SiTef/Fiserv até a adquirente e o autorizador.
- Retorno — o m-Sitef devolve o resultado ao app chamador (aprovação/negação, dados do comprovante e identificadores da transação).
O contrato exato do Intent (nome da ação, chaves de extras de entrada e de retorno) é definido pela documentação oficial da Software Express e pode variar por versão do m-Sitef. Use a referência oficial de integração como fonte da verdade para os nomes dos campos.
Atestação e monitoramento
O m-Sitef executa atestação e monitoramento contínuos via ToP Gateway, conforme o padrão PCI MPoC. Isso garante que apenas dispositivos e instalações íntegras processem pagamentos — qualquer falha nessas verificações interrompe a transação antes da captura.