# 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](https://docs.globalgetnet.com/es/products/in-store-payments/host-to-host?doc=h2h-pinpad-encryption). | 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: 1. Revise la [**Configuración del Entorno**](https://docs.globalgetnet.com/es/products/in-store-payments/host-to-host?doc=h2h-environment-setup\§ion=qhv6nzspm4fa7zajc43yr3ka) para configurar su terminal Newland N750P y su entorno de Android Studio. 2. Siga la guía de [**Verificación de Conectividad**](https://docs.globalgetnet.com/es/products/in-store-payments/host-to-host?doc=h2h-configuration-and-connectivity\§ion=qhv6nzspm4fa7zajc43yr3ka) para realizar su primera prueba de conexión con el comando Echo Request (Y0I).