Principais Questões para Integração de Novos Clientes

Este documento apresenta questões importantes que precisam ser abordadas sobre o uso do app.

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.