> 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/apendices.md).

# Apêndices

Esta secção contém materiais de consulta rápida e referências normativas que auxiliam na compreensão dos dados processados pelo módulo EMV e no entendimento da terminologia técnica utilizada.

### Apêndice A. Tags EMV (Campo 55) Relevantes

As tags listadas abaixo são as mais relevantes para a integração com o módulo. Todas elas trafegam no payload dentro do campo `field55EmvTags`, codificadas no formato TLV (Tag-Length-Value) em hexadecimal .

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Tag</th><th>Nome</th><th>Descrição Técnica</th></tr></thead><tbody><tr><td><code>9F26</code></td><td><em>Application Cryptogram</em></td><td>O ARQC propriamente dito (8 bytes). É extraído automaticamente pelos endpoints EMV.</td></tr><tr><td><code>9F36</code></td><td><em>Application Transaction Counter</em> (ATC)</td><td>Contador sequencial de transações do cartão (2 bytes). Utilizado na derivação da chave de sessão.</td></tr><tr><td><code>9F10</code></td><td><em>Issuer Application Data</em> (IAD)</td><td>Dados proprietários do emissor usados na verificação do ARQC. O tamanho é variável dependendo da bandeira e CVN.</td></tr><tr><td><code>8C</code></td><td>CDOL1</td><td><em>Card Risk Management Data Object List 1</em>. Lista de tags que o cartão solicitou ao terminal para gerar o ARQC.</td></tr><tr><td><code>9F02</code></td><td><em>Amount, Authorised</em></td><td>Valor da transação autorizada, em centavos, formato de 12 dígitos BCD.</td></tr><tr><td><code>5F2A</code></td><td><em>Transaction Currency Code</em></td><td>Código ISO 4217 numérico da moeda (ex.: <code>986</code> para BRL).</td></tr><tr><td><code>9A</code></td><td><em>Transaction Date</em></td><td>Data da transação no formato YYMMDD (3 bytes).</td></tr><tr><td><code>9C</code></td><td><em>Transaction Type</em></td><td>Código do tipo de transação (<code>00</code> = compra, <code>01</code> = compra com cashback, <code>20</code> = refund).</td></tr><tr><td><code>91</code></td><td><em>Issuer Authentication Data</em></td><td>Tag na qual o ARPC é transportado de volta ao cartão. Tipicamente contém o ARPC (8 bytes) + ARC (2 bytes) ou ARPC + CSU.</td></tr></tbody></table>

{% hint style="info" %}
Referência Normativa\
A especificação EMV completa sobre as tags está disponível no documento EMV 4.x, Book 3 — Application Specification, publicado pela EMVCo . Para particularidades de cada bandeira, consulte também os cadernos proprietários (ex.: Visa VIS, Mastercard M/Chip Requirements).
{% endhint %}

### Apêndice B. Glossário

Dicionário de siglas e termos técnicos que aparecem ao longo da documentação da Hop V4 .

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Termo / Sigla</th><th>Definição</th></tr></thead><tbody><tr><td>AAC</td><td><em>Application Authentication Cryptogram</em>. Criptograma gerado pelo cartão quando a transação é recusada.</td></tr><tr><td>AES</td><td><em>Advanced Encryption Standard</em>. Algoritmo simétrico usado em esquemas EMV modernos.</td></tr><tr><td>ARC</td><td><em>Authorization Response Code</em>. Código de 2 bytes em hexadecimal que representa a resposta do emissor (ex.: <code>00</code> = aprovado, <code>05</code> = negado). Usado no método 1 de ARPC.</td></tr><tr><td>ARPC</td><td><em>Authorization Response Cryptogram</em>. Criptograma gerado pelo emissor em resposta ao ARQC.</td></tr><tr><td>ARQC</td><td><em>Authorization Request Cryptogram</em>. Criptograma gerado pelo cartão no início da autorização online.</td></tr><tr><td>ATC</td><td><em>Application Transaction Counter</em>. Contador sequencial do cartão, incrementado a cada transação.</td></tr><tr><td>BIN</td><td><em>Bank Identification Number</em>. Primeiros 6 a 8 dígitos do PAN, que identificam o emissor e o produto.</td></tr><tr><td>CDOL1</td><td><em>Card Risk Management Data Object List 1</em>. Lista de tags que o cartão solicita do terminal para gerar o ARQC.</td></tr><tr><td>CSU</td><td><em>Card Status Update</em>. Campo de 4 bytes em hexadecimal que representa a resposta do emissor no método 2 de ARPC.</td></tr><tr><td>CVN</td><td><em>Cryptogram Version Number</em>. Versão do esquema criptográfico usado pelo cartão.</td></tr><tr><td>EMV</td><td>Padrão internacional para transações com cartões chip, mantido pela EMVCo.</td></tr><tr><td>EMVCo</td><td>Consórcio mantenedor do padrão EMV, composto por Amex, Discover, JCB, Mastercard, UnionPay e Visa.</td></tr><tr><td>HSM</td><td><em>Hardware Security Module</em>. Dispositivo dedicado para armazenamento e uso de chaves criptográficas.</td></tr><tr><td>IAD</td><td><em>Issuer Application Data</em>. Tag <code>9F10</code> — dados proprietários do emissor usados na verificação do ARQC.</td></tr><tr><td>ISO 8583</td><td>Padrão internacional de mensageria para transações de cartão de pagamento.</td></tr><tr><td>JWT</td><td><em>JSON Web Token</em>. Formato do token emitido pelo OAuth2 e usado no cabeçalho <code>Authorization</code>.</td></tr><tr><td>MK-AC</td><td><em>Master Key for Application Cryptogram</em>. Chave mestra do emissor usada para derivar a chave de sessão do cartão.</td></tr><tr><td>MPVV</td><td><em>Mastercard PIN Verification Value</em>. Algoritmo proprietário Mastercard para verificação de PIN.</td></tr><tr><td>OAuth2</td><td>Protocolo de autorização. A Hop V4 utiliza o fluxo <code>client_credentials</code>.</td></tr><tr><td>OTPK</td><td><em>One-Time Pin Key</em>. Chave de uso único em alguns esquemas.</td></tr><tr><td>PAN</td><td><em>Primary Account Number</em>. Número do cartão.</td></tr><tr><td>PCI HSM</td><td>Padrão do <em>PCI Security Standards Council</em> para HSMs que processam dados de cartão.</td></tr><tr><td>PIN</td><td><em>Personal Identification Number</em>.</td></tr><tr><td>PSN</td><td><em>PAN Sequence Number</em>. Identifica aplicações adicionais no mesmo cartão.</td></tr><tr><td>qVSDC</td><td><em>Quick Visa Smart Debit/Credit</em>. Esquema contactless da Visa.</td></tr><tr><td>Scheme ID</td><td>Identificador do esquema criptográfico EMV utilizado pelo cartão.</td></tr><tr><td>TC</td><td><em>Transaction Certificate</em>. Criptograma gerado pelo cartão ao final de uma transação offline aprovada.</td></tr><tr><td>TLV</td><td><em>Tag-Length-Value</em>. Formato de codificação usado em EMV para estruturar os dados do campo 55.</td></tr><tr><td>VIS</td><td><em>Visa Integrated Circuit Card Specification</em>. Esquema tradicional Visa.</td></tr></tbody></table>


---

# 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/apendices.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.