For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

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.

Last updated