> For the complete documentation index, see [llms.txt](https://ftcoders.first-tech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ftcoders.first-tech.com/first-tech-ttp-sdk-pt/introducao/especificacoes-e-recursos.md). # Especificações e Recursos ### 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 ``` ```
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.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ftcoders.first-tech.com/first-tech-ttp-sdk-pt/introducao/especificacoes-e-recursos.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.