Glosario

Esta referencia define los términos técnicos, las abreviaturas y los formatos de datos usados en toda la documentación de integración de Getnet Pinpad Host-to-Host.

Términos generales

Los siguientes términos definen los principales componentes y direcciones de mensajes dentro del ecosistema de integración:

Término	Definición
Sistema Host	El sistema propio o caja registradora que inicia las solicitudes de transacción y se comunica con el Pinpad a través del puerto serie. También se le denomina localmente Caja o SP (Sistema Propio).
Pinpad (PP)	El terminal físico Newland N750P que ejecuta la aplicación de pago.
Host Request	Un mensaje formateado que el Sistema Host genera y envía para dirigir al Pinpad.
Pinpad Response	Un mensaje formateado que el Pinpad devuelve para comunicar el estado o los datos al Sistema Host.
CTLSS	Una transacción contactless realizada con tecnología NFC.
CHIP	Una transacción con contacto realizada con el circuito integrado EMV de la tarjeta.
BANDA	Una transacción realizada a través de la interfaz de banda magnética de la tarjeta.

Estándar de ID del terminal en Argentina: Getnet usa un código alfanumérico de 8 dígitos que comienza con “PP” para identificar los Puntos de Venta (PDV). Getnet genera este código y debe completarse en el campo “ID del terminal” en cada transacción.

Términos de cifrado

Los siguientes términos describen el modelo de cifrado del Pinpad. Para el esquema completo, consulte Cifrado del Pinpad.

Término	Definición
3DES DUKPT	Derived Unique Key Per Transaction con Triple DES. Cifra el PIN/PINBLOCK y el PAN; nunca las pistas.
RSA	Cifrado asimétrico para los datos de mensajería: Pista I, Pista II, CVV y datos EMV; nunca el PIN ni el PAN.
PINBLOCK	El bloque de PIN cifrado que produce DUKPT y se devuelve en las respuestas `Y19`/`Y02`.
PAN	Primary Account Number (número de tarjeta). Se devuelve cifrado con DUKPT en `ENC-PAN`; enmascarado con ceros dentro de las pistas.
KSN	Key Serial Number de la clave DUKPT del PIN.
KSN-PAN	Key Serial Number de la clave DUKPT del PAN, con un contador independiente de `KSN`.
ENC	Campo de la solicitud que controla el cifrado DUKPT del PAN (`0` desactivado, `1` activado, `2` ranura 3).
PMK	Campo de posición de la clave maestra. PMK del PIN = valor; PMK del PAN = valor + 1.
Ranura de clave (3 / 4)	Posiciones seguras de claves DUKPT. Ranura 3 = PIN (y PAN si es la única clave); ranura 4 = PAN.

Sintaxis y notación

Use las siguientes reglas de notación al interpretar estructuras de comandos y payloads:

Y0X.ABC: Se refiere a un campo específico dentro de un comando.

[!NOTE] En esta notación, Y0X es un marcador de posición donde X representa el ID del comando específico (ej: Y19, Y02, Y0Q). Por ejemplo, Y0Q.QRD se refiere al campo QRD del payload del comando Y0Q.

[Host]: Indica un payload de mensaje originado por el Sistema Host.
[Pinpad]: Indica un payload de mensaje originado por el Pinpad.
// Comentario: Las barras dobles indican texto de aclaración que no forma parte del mensaje transmitido real.
SIN USO: Indica un campo incluido por compatibilidad con protocolos heredados (ej: Lane3000). Estos campos no contienen información relevante para el Pinpad y normalmente usan valores predeterminados.

Tipos de datos y formato

Los campos de comando deben cumplir con estas definiciones de tipos de datos y reglas de codificación:

Atributo	Descripción
A	Carácter alfabético.
N	Carácter numérico.
AN	Carácter alfanumérico.
ANS	Caracteres alfanuméricos y especiales.
H	Carácter hexadecimal.

Representaciones de codificación

ASCII: Las cadenas entre comillas representan la representación ASCII de los bytes transmitidos. Por ejemplo, “01a” representa la secuencia de bytes 30 31 61.
Hexadecimal: Los valores que terminan con h representan bytes hexadecimales en bruto. Por ejemplo, 1Ch indica el valor de byte 1C.

Recursos relacionados

Las páginas siguientes ponen en práctica esta nomenclatura y notación:

Revise la Configuración del Entorno para configurar su terminal Newland N750P y su entorno de Android Studio.
Siga la guía de Verificación de Conectividad para realizar su primera prueba de conexión con el comando Echo Request (Y0I).