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 .

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

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

Apêndice B. Glossário

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

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