> 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/principais-questoes-para-integracao-de-novos-clientes.md).
# Principais Questões para Integração de Novos Clientes
Abaixo está uma lista de perguntas essenciais que devem ser discutidas com o cliente durante o processo de integração e credenciamento. Estas perguntas ajudam a estabelecer uma compreensão clara dos requisitos do projeto antes do início do desenvolvimento, tornando-as um excelente ponto de partida para alinhar expectativas e definir o escopo do desenvolvimento:
Questão: Qual o sistema operacional e a versão mínima do Android compatível com sua aplicação TTP?
As certificações de segurança dos dispositivos, em conformidade com as redes de cartão e órgãos reguladores PCI, certificam o SDK para operar apenas em versões Android 10 ou superior.
Questão: Os aparelhos contam com chip NFC?
Para utilizar aplicativos que habilitam pagamentos sem contato, o dispositivo móvel deve suportar a Tecnologia NFC. Esta tecnologia permite a comunicação entre o dispositivo e cartões de crédito/débito ou carteiras digitais que também possuem capacidades NFC.
Para verificar se um dispositivo móvel possui funcionalidade NFC, consulte as especificações técnicas no site do fabricante ou no manual do produto. Se você tiver o dispositivo em mãos, vá ao aplicativo Configurações e procure por "NFC". Se a opção aparecer, o recurso está instalado e pronto para uso.
Questão: O app necessita da leitura física do chip ou da tarja magnética do cartão?
Este SDK lê dados exclusivamente via tecnologia sem contato (NFC) e não é compatível com leitura de chip ou tarja magnética. Para estas funcionalidades, você pode combinar este SDK com outros SDKs da indústria de pagamentos que se integram com Android, como os da TecToy ou Gertec. Neste caso, o SDK externo é responsável por gerenciar a comunicação com o chip ou tarja magnética.
Questão: Qual tipo de conexão de rede está disponível na região onde estas aplicações serão usadas? (Wi-Fi/Dados móveis) ?
Este SDK suporta Wi-Fi e redes móveis de alta velocidade (3G ou superiores). O Android gerencia a alternância entre as conexões automaticamente, mas o desempenho em redes lentas (como 2G/EDGE) deve ser validado pelo desenvolvedor.
Questão: Qual linguagem de programação é usada no app que irá integrar o SDK da TTP?
O SDK foi desenvolvido em Java/Kotlin, mas também é compatível com linguagens híbridas como React Native, que, através de um recurso chamado 'bridge', permite a comunicação com código escrito em outras linguagens. É importante observar que o uso de linguagens sem essa funcionalidade de 'bridge' ou recém-lançadas, como .NET MAUI, pode levar a comportamentos inesperados no SDK. Recomendamos informar o cliente sobre esse potencial problema no início da negociação.
Para facilitar a integração, fornecemos aplicações de exemplo que demonstram como o SDK funciona em diferentes cenários. Estes exemplos estão disponíveis no início do processo de onboarding, juntamente com diretrizes de implementação.
Questão: A aplicação irá funcionar em dispositivos com acesso root, em conjunto com apps instalados de fontes externas (fora da Google Play) ou com aplicativos em modo debugger?
Para garantir a segurança das transações, o SDK não funcionará em smartphones que:
* Tenham acesso Jailbreak/Root ativado: Isso compromete a segurança do sistema e aumenta o risco de aplicativos maliciosos obterem acesso.
* Tenham ferramentas de desenvolvedor habilitadas: O modo de depuração pode expor o dispositivo a vulnerabilidades.
* Tenham aplicativos maliciosos instalados: Tais aplicativos podem interferir na operação do SDK e tentar roubar dados.
* Tenham qualquer depurador conectado: Depuradores podem ser usados para manipular o aplicativo e o SDK.
* Tenham data e hora configuradas manualmente: Configurações corretas de data e hora são cruciais para a validação de transações.
* Tenham o aplicativo instalado ou baixado de fontes fora da Google Play: Aplicativos de fontes externas podem não ser seguros.
Nestes casos, o SDK não será ativado, pois o processo de verificação de integridade do dispositivo detectará riscos de segurança.
Questão: Qual bandeira de cartão será processada? Quais métodos de pagamento serão aceitos?
O SDK processa transações de crédito (pagamento único e parcelado) e débito para as redes de cartão Visa, Mastercard e Elo. Transações via carteiras digitais (Google Pay, Apple Pay e Samsung Pay) também são suportadas, desde que os cartões vinculados pertençam a essas redes.
\
Para integrar Pix e outros métodos de pagamento (como boletos e transferências bancárias), utilize a API da adquirente. Esta integração direta proporciona maior flexibilidade para implementação e permite que a adquirente personalize os fluxos de pagamento.
Pergunta: O aplicativo possui alguma restrição quanto a ser instanciado a partir da classe Application no Android?
* Seguindo os padrões de segurança MPOC (regulamentação PCI para este produto), o SDK não pode ser integrado com outros aplicativos ou SDKs—ele deve permanecer isolado.
* Esta restrição impede a instanciação não autorizada, garantindo que outras classes não possam inicializar o SDK parcialmente, incompletamente ou sem autorização. Isso mantém o princípio de isolamento, previne vulnerabilidades de segurança e preserva a certificação existente do produto (garantindo conformidade com o fluxo certificado).
* Ao ser instanciado na classe principal do aplicativo, o SDK se beneficia de um ciclo de vida mais longo em comparação com outras Activities e Fragments. Isso garante que a inicialização ocorra apenas uma vez, que os processos de criptografia não sejam perdidos entre telas ou atividades, e que o monitoramento de integridade do aplicativo cubra todo o escopo da aplicação.
---
# 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/principais-questoes-para-integracao-de-novos-clientes.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.