> 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/contato-nfc-e-pagamento.md).

# Contato NFC e Pagamento

**Objetivo**

Estabelecer os requisitos mínimos para a interface e o comportamento do sistema durante a fase de pagamento via NFC, no momento em que o cartão ou dispositivo é aproximado. Esta etapa é crítica para a experiência do usuário e exige clareza, feedback em tempo real e sensação de segurança.

**Diretrizes**

* As animações NFC devem seguir os padrões das plataformas (Android/iOS) para garantir segurança e compatibilidade.
* A ilustração de proximidade deve respeitar proporcionalidade e semântica entre mão, cartão e celular.
* Essa tela deve ser testada em diferentes contextos: POS embarcados, dispositivos móveis com NFC, carteiras digitais.

***

<figure><img src="/files/KWNZ5c9MR2JiEVbN6bTw" alt=""><figcaption></figcaption></figure>

## **Tela de Contato NFC** <a href="#nfc-contact-screen" id="nfc-contact-screen"></a>

### 01 - Valor e tipo de pagamento <a href="#id-01-amount-and-payment-type" id="id-01-amount-and-payment-type"></a>

Devem ser exibidos de forma clara (ex.: “R$ 122,00 – Crédito à vista”)

### 02 - Ilustração de pagamento por aproximação <a href="#id-02-contactless-illustration" id="id-02-contactless-illustration"></a>

Deve indicar claramente o gesto de proximidade entre cartão e dispositivo

### 03 - Indicador NFC ativo <a href="#id-03-active-nfc-indicator" id="id-03-active-nfc-indicator"></a>

Ícone animado ou pulsante sinalizando prontidão para leitura

### 04 - Cupom promocional (opcional) <a href="#id-04-promotional-coupon-optional" id="id-04-promotional-coupon-optional"></a>

Pode ser exibido na parte inferior como incentivo de fidelidade

### 05 - Métodos de pagamento aceitos <a href="#id-05-accepted-payment-methods" id="id-05-accepted-payment-methods"></a>

Exibir ícones atualizados das bandeiras e carteiras digitais compatíveis

{% hint style="success" %}
**Obrigatório:**\
A tela deve bloquear interações secundárias e concentrar a atenção do usuário na ação de aproximação NFC.
{% endhint %}

{% hint style="info" %}
**Recomendado:**\
Fornecer feedback tátil (vibração) ou sonoro quando um cartão ou celular compatível for detectado.
{% endhint %}

***

## **Transação Aprovada** <a href="#approved-transaction" id="approved-transaction"></a>

### 06 - Indicador de sucesso <a href="#id-06-success-indicator" id="id-06-success-indicator"></a>

Círculo verde com ícone de check e a mensagem “Transação aprovada”

### 07 - Botão “Enviar comprovante” <a href="#id-07-send-receipt-button" id="id-07-send-receipt-button"></a>

Deve permitir o envio do comprovante via e-mail, WhatsApp ou outros canais configurados

### 08 - Botão “Finalizar compra” <a href="#id-08-finish-purchase-button" id="id-08-finish-purchase-button"></a>

Deve concluir a operação e retornar para a tela inicial ou para um estado de carrinho vazio

{% hint style="success" %}
**Obrigatório:**\
O feedback de sucesso deve aparecer instantaneamente (<1s após a aprovação)
{% endhint %}

{% hint style="info" %}
Recomendad&#x6F;**:**\
Reforçar o valor e o método de pagamento na tela de confirmação para maior segurança visual.
{% endhint %}

***

## **Transação Recusada** <a href="#declined-transaction" id="declined-transaction"></a>

### 09 - Indicador de erro <a href="#id-09-error-indicator" id="id-09-error-indicator"></a>

Círculo vermelho com um “X” e a mensagem “Transação recusada”

### 10 - Botão “Cancelar” <a href="#id-10-cancel-button" id="id-10-cancel-button"></a>

Deve encerrar o processo de pagamento e retornar ao catálogo

### 11 - Botão “Tentar novamente” <a href="#id-11-try-again-button" id="id-11-try-again-button"></a>

Deve reiniciar o processo de leitura NFC mantendo os dados atuais da transação

{% hint style="success" %}
**Obrigatório:**\
As mensagens devem ser claras e não atribuir culpa ao usuário (“Cartão recusado”, e não “Erro do usuário”)
{% endhint %}

{% hint style="info" %}
**Recomendado::**\
Se possível, exibir o motivo da falha (ex.: “Fundos insuficientes”, “Cartão expirado”)
{% endhint %}

***

## **Mensagens Obrigatórias**

* **Pagamento aprovado:**

> Transação aprovada. Obrigado!

* **Pagamento recusado:**

> Transação recusada. Verifique seu cartão ou tente outro método de pagamento.

***

**Comportamentos Esperados**

* A tela NFC deve permanecer ativa por até 60 segundos ou até ser cancelada manualmente.
* A resposta do NFC deve ocorrer em tempo real (máximo de 2 segundos de latência).
* Os usuários devem ter controle claro para tentar novamente ou sair do fluxo.
* Após um erro, o módulo NFC deve ser totalmente reinicializado antes de uma nova tentativa.


---

# 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/contato-nfc-e-pagamento.md?ask=<question>&goal=<endgoal>
```

`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.