For the complete documentation index, see llms.txt. This page is also available as Markdown.

Especificações e Recursos

Esta página descreve todas as Especificações e Recursos do SDK First Tech TTP

Funcionalidades do Produto

Abaixo estão as principais funcionalidades do produto, abrangendo hardware, software, certificações e cenários de negócio aplicáveis.

Hardware
  • Dispositivos Compatíveis: Sem restrições, desde que o dispositivo possua um chip NFC ativo.

  • Sistemas Operacionais: Android (suporte para iOS* disponível mediante solicitação).

  • Requisito NFC: O NFC deve estar habilitado para leitura e transmissão de dados de pagamento. Qualquer smartphone com chip NFC ativo pode utilizar o produto, independentemente do fabricante.

  • TEE ou Elemento Seguro: O smartphone deve possuir um processador dedicado ou um chip de segurança para gerenciamento de chaves criptográficas. Isso é necessário para utilizar as APIs Android Keystore e Key Attestation. Qualquer dispositivo Android executando a versão 10 ou posterior com acesso à Google Play Store atende a esses requisitos.

  • Leitura de Chip e Tarja Magnética: O SDK não oferece suporte a leitores de cartão com chip ou tarja magnética. Apenas cartões habilitados para pagamento por aproximação podem ser utilizados.

  • Conectividade de Rede: Requer Wi-Fi ou dados móveis com pelo menos cobertura 3G para ativação do terminal e processamento de transações.

*Ainda não estamos disponíveis no iOS. Registre seu interesse para ser avisado em primeira mão quando lançarmos

Software
  • Linguagens de Programação: O SDK é desenvolvido em Java, mas pode ser utilizado com tecnologias híbridas como React Native, Flutter ou qualquer linguagem que suporte ponte para bibliotecas nativas.

  • Versão Mínima do Android: Android 10 ou posterior.

  • API Android: Nível 29 ou posterior.

  • Versão do Google Play Services: Play Services 11 ou posterior.

  • Permissões Obrigatórias para aplicativos construídos com o SDK:

    • (NFC) android.Manifest.permission.NFC

    • (Vibrar) android.Manifest.permission.VIBRATE

    • (Internet) android.permission.INTERNET

    • (Estado da Rede) android.permission.ACCESS_NETWORK_STATE

    • (Política de Notificação) android.permission.ACCESS_NOTIFICATION_POLICY

  • Permissões Recomendadas para aplicativos construídos com o SDK:

    • (Localização) android.permission.ACCESS_COARSE_LOCATION

    • (Localização) android.permission.ACCESS_FINE_LOCATION

Permissões

Permissões necessárias

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.VIBRATE"/>
<uses-permission android:name="android.permission.ACCESS_NOTIFICATION_POLICY"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.NFC"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
Certificações

Segurança e Conformidade : PCI HSM, PCI PIN, PCI DSS, PIN on Glass, Visa Security 1.8.1, MPOC 1.1, ISO 27001.

Restrições de Uso em Produção

O SDK não funcionará em smartphones que: - Estejam com modo jailbreak/root ativado. - Estejam com opções de desenvolvedor habilitadas (modo de depuração). - Possuam aplicativos maliciosos instalados. - Estejam com qualquer depurador conectado. - Estejam com configurações manuais de data e hora (deve estar configurado como automático). - Tenham o aplicativo instalado de fontes externas à Google Play. - Estiver rodando a aplicação em emulador.

Capacidades do SDK
  • Criação do Terminal: O terminal é criado automaticamente quando uma solicitação de transação é iniciada. Uma verificação de segurança é realizada para garantir a integridade do sistema antes da criação do terminal.

  • Criação da Sessão: Uma sessão é criada automaticamente após uma nova solicitação de transação. O terminal executa uma validação completa de segurança com o servidor central antes de processar qualquer transação.

  • Processamento de Transações: Suporta transações de crédito (pagamentos únicos e parcelados) e débito.

  • Suporte a Pré-pagamento: Não fornecido pelo SDK.

  • Reembolsos (D+1 ou posterior): Podem ser processados via API ou através do banco adquirente.

Casos de Uso Use Cases
  • Terminal Móvel de Pagamento Um novo aplicativo deve ser desenvolvido utilizando o SDK. Controle de usuário, lógica de negócio, alternância de contexto de CNPJ, integrações de métodos adicionais de pagamento, personalização de interface e outras funcionalidades específicas devem ser implementadas pela empresa que utiliza o SDK.

  • Transferências de Transações Online para Offline (E-commerce) O aplicativo deve ser desenvolvido com aprovação das redes de cartão participantes sob o programa Tap to Everything / Tap to Own Device. Relatórios dos comerciantes devem ser enviados mensalmente, e ajustes nas mensagens ISO 8583 devem ser feitos para sinalizar adequadamente as transações que se originaram online, mas foram processadas offline.

  • Suporte a Pré-pagamentos (Não fornecido pelo SDK) Se incorporado a um aplicativo, o SDK pode capturar pré-pagamentos. O modo de pré-pagamento deve ser comunicado ao gateway de pagamento, e o banco adquirente deve fornecer métodos para modificar, cancelar ou converter pré-pagamentos em pagamentos padrão.

  • Identificação de Usuário via Cartão Os dados capturados por NFC podem ser utilizados para criar uma impressão digital do cartão de crédito e vinculá-la a um banco de dados de clientes. Isso permite que o SDK identifique usuários além da simples coleta de pagamentos, facilitando a integração com programas de fidelidade e melhorando os fluxos de login onde a autenticação tradicional é ineficaz.

  • Tap to Fill e Cadastro em Carteira Digital Em aplicativos de carteira digital ou e-commerce, a tecnologia NFC pode capturar automaticamente o número do cartão e a data de validade, simplificando o processo de checkout e eliminando a entrada manual—semelhante à digitalização de um cartão de crédito usando uma câmera.

Atualizado