> 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/finalizacao-manual-da-venda.md).
# Finalização Manual da Venda
**Objetivo**
Estabelecer os requisitos mínimos para o fluxo de finalização manual da venda, permitindo que vendedores insiram valores de transação, selecionem o método de pagamento e concluam a operação via NFC (Tap to Pay), com clareza, segurança e eficiência.
**Insights**
* O fluxo deve estar em conformidade com os padrões PCI MPoC para pagamentos por proximidade.
* A interação via NFC deve ser testada em diversos tipos de dispositivos (terminais POS e smartphones).
* O tempo entre a seleção do método de pagamento e a detecção NFC não deve exceder 5 segundos, salvo em cenários técnicos justificados.
***
## **Acesso ao Fluxo de Finalização (Checkout)**
### 01 - Ícone “Cobrar” na barra de navegação inferior
Deve estar sempre visível como item principal de navegação. Ao ser selecionado, deve abrir a tela de inserção do valor.
{% hint style="success" %}
**Obrigatório:**\
O fluxo de cobrança/finalização deve ser acessível de qualquer ponto do aplicativo e ter destaque visual equivalente às entradas de carrinho ou catálogo.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Exibir feedback visual de foco ativo ao tocar no ícone.
{% endhint %}
***
## **Inserção do Valor para Checkout**
### 02 - Campo de entrada de valor
Deve estar centralizado, com fonte legível e cursor ativo. Somente entradas numéricas válidas devem ser aceitas.
### 03 - Sugestões rápidas de valores
Valores predefinidos (ex.: R$ 50, R$ 85) devem estar visíveis e ser clicáveis.
### 04 - Teclado numérico personalizado
Deve ser interno ao aplicativo (não o teclado padrão do sistema), com botões grandes e responsivos.
{% hint style="success" %}
**Obrigatório:**\
O botão “Continuar” deve permanecer desabilitado até que um valor maior que zero seja inserido.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Aplicar automaticamente a formatação monetária durante a digitação (ex.: 12200 → 122,00).
{% endhint %}
***
## **Seleção do Método de Pagamento**
### 05 - Modal de métodos de pagamento
Deve incluir, no mínimo, as seguintes opções:
* Tap to Pay
* Pix
* Link de Pagamento
A ordem pode variar, mas o Tap to Pay deve estar claramente visível e acessível.
{% hint style="success" %}
**Obrigatório:**\
A seleção deve ser clara, com uso de ícone e rótulo, seguindo os padrões de acessibilidade.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Lembrar o último método de pagamento selecionado para reutilização mais rápida.
{% endhint %}
***
## **Definição do Tap to Pay**
### 06 - Seleção Crédito/Débito
O usuário deve selecionar entre “Crédito” ou “Débito”, com indicação visual clara da opção escolhida.
### 07 - Opções de parcelamento (se aplicável)
Se “Crédito” for selecionado, devem ser exibidas as opções de parcelamento disponíveis, com valor por parcela e total da compra.
### 08 - Botão “Continuar”
Só deve ser habilitado após a seleção do tipo de pagamento e do número de parcelas (quando necessário).
{% hint style="success" %}
**Obrigatório:**\
As opções de pagamento devem estar em conformidade com as regras das bandeiras de cartão e dos terminais.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Exibir um resumo das opções selecionadas antes de avançar para a tela final de checkout.
{% endhint %}
***
## **Checkout via NFC**
### **Tela de solicitação NFC**
Deve exibir o valor final e o tipo de pagamento (ex.: “Crédito – à vista”), com ilustração clara do gesto de proximidade do cartão ou celular.
{% hint style="success" %}
**Obrigatório:**\
O sistema deve aguardar a proximidade NFC e processar o pagamento automaticamente ao detectar o dispositivo.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Fornecer feedback visual (ex.: animação), sonoro ou vibratório ao detectar e concluir o pagamento com sucesso.
{% endhint %}
***
## **Mensagens Obrigatórias**
* Quando nenhum valor for inserido:
> Por favor, insira um valor para continuar.
* Quando o NFC não for detectado:
> Nenhum contato detectado. Ajuste o posicionamento e tente novamente.
***
## **Comportamentos Esperados**
* O fluxo completo deve ser conciso (máximo de 5 etapas antes do pagamento).
* Todos os valores e opções devem estar claramente visíveis em cada etapa.
* O usuário deve poder corrigir as entradas antes da confirmação final.
---
# 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/finalizacao-manual-da-venda.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.