> 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/hop-api/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.

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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ftcoders.first-tech.com/hop-api/modulo-emv/introducao-modulo-emv.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.