> 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/landing-page/modulo-emv/introducao-modulo-emv.md).

# Introdução: Módulo EMV

O módulo EMV da plataforma Hop V4 é destinado à validação de ARQC e à geração de ARPC em transações EMV (chip) de crédito e débito. Este guia fornece as referências técnicas necessárias para o consumo seguro e eficiente das operações criptográficas expostas pela API da First Tech.

### Público-alvo e Pré-requisitos

Este documento é direcionado a desenvolvedores, integradores e arquitetos de sistemas de pagamento que precisam implementar as funcionalidades de validação e geração de criptogramas.

{% hint style="info" %}
**Conhecimento Prévio Necessário**\
Presume-se que o leitor conheça os fundamentos do padrão EMV e compreenda a estrutura de uma mensagem de autorização de pagamento com cartão chip. Termos técnicos específicos utilizados ao longo do texto podem ser consultados diretamente no Glossário.
{% endhint %}

### O que este documento cobre

A documentação está desenhada para cobrir de ponta a ponta a implementação do módulo, englobando:

* **Fundamentos EMV:** Conceitos essenciais relevantes para o uso dos endpoints.
* **Especificação da API:** Detalhamento completo dos endpoints `ValidateARQC4x` e `GenerateARPC4x`.
* **Modelagem de Dados:** Estrutura completa de payloads de requisição e resposta.
* **Regras de Validação:** Matriz de obrigatoriedade condicional de campos de acordo com o modo de operação.
* **Operação e Suporte:** Códigos de erro, estratégias de *troubleshooting*, fluxos de integração e exemplos práticos.

### O que este documento não cobre

Para manter o foco no processamento EMV, os tópicos abaixo não fazem parte deste escopo:

* **Outros Módulos PayShield da Hop V4:** Funcionalidades de Key Manager, Crypto, PIN, CVV, PAN e RSA possuem documentação própria.
* **Autenticação:** O fluxo OAuth2 para emissão de tokens JWT é coberto em um documento separado de autenticação da Hop V4.
* **Onboarding Comercial:** O credenciamento de clientes é conduzido exclusivamente pelos times de pré-vendas e comercial.
* **Especificação Oficial EMVCo:** Este material é um guia de uso do módulo Hop, e não uma referência normativa ao padrão EMV.


---

# 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/landing-page/modulo-emv/introducao-modulo-emv.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.