> 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/inicializacao-do-aplicativo.md).
# Inicialização do Aplicativo
**Objetivo**
Esta seção define os **requisitos mínimos para o fluxo de inicialização do aplicativo**, assegurando que o ambiente do dispositivo esteja **adequado e seguro** para processar pagamentos por aproximação (**Tap to Pay**).
**Diretrizes**
* Recomenda-se o uso de **ilustrações amigáveis** para reduzir a fricção durante o processo de verificação de segurança.
* O botão **“Continuar”** deve estar **visualmente e funcionalmente vinculado à validação bem-sucedida dos critérios de segurança**.
* Esta etapa é **obrigatória** para garantir a **conformidade com as melhores práticas de segurança** em pagamentos por aproximação (ex.: **PCI MPoC**).
***
## **Tela de Boas-Vindas**
### **01 – Ícone ilustrativo**
Deve representar visualmente o contexto da loja. É permitido o uso de identidade visual personalizada, desde que respeite critérios mínimos de legibilidade e contraste adequado com o fundo da interface.
### **02 – Mensagem de boas-vindas**
Deve incluir o nome da loja e uma mensagem curta que oriente o usuário no início da navegação pelo aplicativo, reforçando o contexto do ambiente de vendas.
### **03 – Botão “Entrar”**
Deve estar claramente destacado como a ação principal da tela. Ao ser acionado, ele deve obrigatoriamente iniciar o processo de verificação de segurança do ambiente antes de liberar o acesso às funcionalidades do aplicativo.
{% hint style="success" %}
**Obrigatório:**\
Deve haver um botão claro e visível para iniciar a verificação do ambiente do dispositivo antes da habilitação da funcionalidade de pagamento.
{% endhint %}
***
## **Checklist de Segurança**
### **04 – Ilustração com lupa:**
Elemento visual opcional. É recomendada sua utilização para simbolizar inspeção, verificação ou checagem de segurança, ajudando a comunicar o propósito da etapa de forma intuitiva.
### **05 – Lista de verificação de segurança:**
Deve incluir todos os critérios que são avaliados durante a varredura de segurança do ambiente do dispositivo. Os itens devem estar descritos de maneira clara e acessível, permitindo ao usuário acompanhar o processo.
{% hint style="success" %}
**Obrigatório:**\
Cada item da checklist deve indicar visualmente se está **válido ou inválido**, de forma inequívoca, para que o usuário compreenda com clareza quais requisitos foram atendidos e quais ainda precisam ser resolvidos.
{% endhint %}
***
## **Ambiente Pronto**
### **06 – Todos os itens marcados como verificados:**
Todos os critérios da checklist de segurança devem estar **positivamente validados**, sinalizando que o ambiente do dispositivo está apto para realizar transações por aproximação com segurança.
### **07 – Botão “Continuar” (habilitado):**
Deve ser apresentado como a **ação principal da tela** e só pode ser habilitado quando **todos os itens da verificação forem concluídos com sucesso**.
{% hint style="success" %}
**Obrigatório:**\
O botão “Continuar” só deve se tornar disponível quando **todos os itens da checklist estiverem validados**. Ao ser pressionado, a ação deve conduzir diretamente à **interface de vendas** do aplicativo.
{% endhint %}
***
## **Ambiente com Restrições**
### 08 - Item inválido destacado em vermelho
Exemplo: NFC desativado. O item deve ser visualmente enfatizado com um ícone vermelho e um rótulo explicativo claro.
### 09 - Botão “Continuar” (desativado)
O botão deve estar claramente inativo (acinzentado) e não clicável enquanto qualquer item da checklist não estiver satisfeito.
{% hint style="success" %}
**Obrigatório:**\
O botão "Continuar" deve permanecer desativado até que todos os requisitos da checklist sejam atendidos.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Exibir uma orientação contextual para o usuário, como “Ative o NFC para continuar.”
{% endhint %}
***
## **Comportamentos Esperados**
* A checklist deve ser executada automaticamente após pressionar “Enter”.
* Um feedback visual imediato deve ser fornecido (ícone verde ou vermelho) para cada item da checklist.
* Caso algum requisito não seja atendido, a interface deve informar claramente o usuário em linguagem não técnica.
* O botão “Continuar” deve estar disponível somente quando todas as validações forem aprovadas.
## **Mensagens Obrigatórias**
* Quando o NFC estiver desativado:
> NFC desativado. Por favor, ative o NFC para continuar usando o Tap to Pay.
* Quando o aplicativo estiver rodando em um ambiente suspeito:
> Ambiente inseguro detectado. Por favor, verifique a integridade do seu dispositivo.
---
# 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/inicializacao-do-aplicativo.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.