# Glossário Esta referência define os termos técnicos, as abreviações e os formatos de dados usados em toda a documentação de integração Getnet Pinpad Host-to-Host. ## Termos gerais Os termos a seguir definem os principais componentes e as direções de mensagem no ecossistema de integração: | Termo | Definição | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Sistema Host** | O sistema proprietário ou caixa registradora que inicia as requisições de transação e se comunica com o Pinpad pela porta serial. Também chamado localmente de **Caja** ou **SP** (Sistema Propio). | | **Pinpad (PP)** | O terminal físico Newland N750P que executa o aplicativo de pagamento. | | **Requisição do Host** | Mensagem formatada gerada e enviada pelo Sistema Host para direcionar o Pinpad. | | **Resposta do Pinpad** | Mensagem formatada retornada pelo Pinpad para informar status ou dados ao Sistema Host. | | **CTLSS** | Transação contactless realizada com tecnologia NFC. | | **CHIP** | Transação com contato realizada com o circuito integrado EMV do cartão. | | **BANDA** | Transação realizada pela interface de **tarja magnética** do cartão. | > **Padrão de ID de terminal na Argentina:** A Getnet usa um código alfanumérico de 8 dígitos iniciado por "PP" para identificar Pontos de Venda (PDV). Esse código é gerado pela Getnet e deve ser preenchido no campo "ID del terminal" em todas as transações. ## Termos de criptografia Os termos a seguir descrevem o modelo de criptografia do Pinpad. Para o esquema completo, consulte [Criptografia do Pinpad](https://docs.globalgetnet.com/pt/products/in-store-payments/host-to-host?doc=h2h-pinpad-encryption). | Termo | Definição | | --------------------------- | --------------------------------------------------------------------------------------------------------------------- | | **3DES DUKPT** | Derived Unique Key Per Transaction com Triple DES. Criptografa o PIN/PINBLOCK e o PAN; nunca as trilhas. | | **RSA** | Criptografia assimétrica para dados de mensageria: Trilha I, Trilha II, CVV e dados EMV; nunca o PIN nem o PAN. | | **PINBLOCK** | O bloco de PIN criptografado produzido pelo DUKPT e retornado nas respostas `Y19`/`Y02`. | | **PAN** | Primary Account Number (número do cartão). Retornado criptografado com DUKPT como `ENC-PAN`; mascarado com zeros dentro das trilhas. | | **KSN** | Key Serial Number da chave DUKPT de PIN. | | **KSN-PAN** | Key Serial Number da chave DUKPT de PAN, com um contador independente do `KSN`. | | **ENC** | Campo de requisição que controla a criptografia DUKPT do PAN (`0` desativada, `1` ativada, `2` slot 3). | | **PMK** | Campo da posição da chave mestra. PMK do PIN = valor; PMK do PAN = valor + 1. | | **Slot de chave (3 / 4)** | Posições seguras de chave DUKPT. Slot 3 = PIN (e PAN, se for a única chave); slot 4 = PAN. | ## Sintaxe e notação Use as regras de notação a seguir ao interpretar estruturas de comando e payloads: * **Y0X.ABC**: Refere-se a um campo específico dentro de um comando. > \[!NOTE] > Nesta notação, **Y0X** é um placeholder no qual **X** representa o ID do comando específico (por exemplo, `Y19`, `Y02`, `Y0Q`). Assim, `Y0Q.QRD` refere-se ao campo **QRD** do payload do comando **Y0Q**. * **\[Host]**: Indica um payload de mensagem originado pelo Sistema Host. * **\[Pinpad]**: Indica um payload de mensagem originado pelo Pinpad. * **// Comentário**: Barras duplas indicam um texto de esclarecimento que não faz parte da mensagem transmitida. * **SIN USO**: Indica um campo incluído para compatibilidade com protocolos legados (por exemplo, Lane3000). Esses campos não contêm informações relevantes para o Pinpad e normalmente usam valores padrão. ## Tipos de dados e formatação Os campos de comando devem seguir estas definições de tipo de dados e regras de codificação: | Atributo | Descrição | | -------- | ------------------------------------- | | **A** | Caractere alfabético. | | **N** | Caractere numérico. | | **AN** | Caractere alfanumérico. | | **ANS** | Caracteres alfanuméricos e especiais. | | **H** | Caractere hexadecimal. | ### Representações de codificação * **ASCII**: Strings entre aspas representam a representação ASCII dos bytes transmitidos. Por exemplo, `“01a”` representa a sequência de bytes `30 31 61`. * **Hexadecimal**: Valores terminados em `h` representam bytes hexadecimais brutos. Por exemplo, `1Ch` indica o valor de byte `1C`. ## Recursos relacionados As páginas abaixo aplicam esta nomenclatura e notação: 1. Revise [**Configuração do Ambiente**](https://docs.globalgetnet.com/pt/products/in-store-payments/host-to-host?doc=h2h-environment-setup\§ion=qhv6nzspm4fa7zajc43yr3ka) para configurar seu terminal Newland N750P e o ambiente do Android Studio. 2. Siga o guia de [**Verificação de Conectividade**](https://docs.globalgetnet.com/pt/products/in-store-payments/host-to-host?doc=h2h-configuration-and-connectivity\§ion=qhv6nzspm4fa7zajc43yr3ka) para realizar seu primeiro teste de conexão com o comando Echo Request (Y0I).