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.

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:

Revise Configuração do Ambiente para configurar seu terminal Newland N750P e o ambiente do Android Studio.
Siga o guia de Verificação de Conectividade para realizar seu primeiro teste de conexão com o comando Echo Request (Y0I).