Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00 Fecha: 21-Nov-2012 Pag.: 1 / 14

Diseo de aplicacin

Pinpad Ingenico

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 2 / 14

Diseo de aplicacin

CONTENIDO

Pg.
1 Formato de mensajes y campos de datos 2 Protocolo de comunicacin 3 Carga de Working key 4 Alta de NIP 5 Cambio de NIP 3 4 5 6 10

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 3 / 14

Diseo de aplicacin

1 Formato de mensajes y campos de datos

Para validar la correcta transmisin de los mensajes en la lnea de transmisin o el cable serial, se define una forma de encapsular cada mensaje de forma que pueda ser validado por el receptor del mismo. Una vez ensamblado cada mensaje, este antes de ser enviado se formatear de la siguiente manera:

Campo STX Tipo Mensaje Longitud

Longitud 1 Byte 3 Bytes 2 bytes

Formato Bin AN Bin

Descripcin

Valor 02h IC0, IC1, 00 9F Ins/Deslice Tarjeta 03h

Inicio de mensaje identificador del mensaje Longitud en bytes de los datos del mensaje. Datos Variable Bin** Informacin del mensaje. ETX 1 Byte Bin Fin del mensaje LRC 1 Byte Bin Resultado de Longitudinal redundancy check (*). (*) Se calcula incluyendo el ETX y excluyendo el STX. (**)

El formato especfico de cada campo que conforman los datos puede ser alguno de los siguientes tipos definidos en la siguiente tabla: Tipo Descripcin / Ejemplos Relleno para valores menores a la longitud mxima (padeo) Espacios a la derecha o izquierda.

Alfanumrico: Caracteres ASCII imprimibles (sin bytes de control). Ejemplos: IC0, DSP, Inserte tarjeta BCD Binario codificado en decimal: Valor numrico (solo dgitos decimales), cada par de dgitos conforman un byte. Ejemplos: 04 84, 00 00 00 12 00 00 HEX Hexadecimal: Valor expresado en hexadecimal (0-F), dos dgitos conforman un byte. Ejemplos: E8 F3, 02 F4 Bin Binario: Al menos se tiene un byte conformado por 8 bits donde cada bit activa o desactiva una funcin. El bit menos significativo de denota como b0 y el ms significativo como b7. En algunos casos se usa el valor binario para configurar un parmetro con su equivalente decimal. Ejemplo: 03 (00000011: b0=1,b1=1, b2=b3=b4=b5=b6=b7=0) Ejemplo: 3C (60 decimal, para configurar un tiempo de 60 seg)

AN

Ceros a la izquierda

Ceros a la izquierda

Ceros en el resto de bits

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00 Fecha: 21-Nov-2012 Pag.: 4 / 14

Diseo de aplicacin

2 Protocolo de comunicacin
De igual forma, para sincronizar los puertos de ambos dispositivos, se utilizar comunicacin asncrona para el intercambio de mensajes entre el pinpad y la caja con la siguiente configuracin por default: 19200,N,8,1 Donde: Velocidad: Paridad: Bits de datos: Bits de parada:

19200 bps Ninguna 8 1

Cada mensaje transmitido o recibido, adems de cumplir con el formato definido en el punto 2 debe ser confirmada su recepcin con un ACK (06h) cuando el LRC recibido coincide con el calculado por el dispositivo receptor o notificar el error en el LRC a travs de un NAK (15h) para que se retransmita.

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00 Fecha: 21-Nov-2012 Pag.: 5 / 14

Diseo de aplicacin

3 Carga Working Key

Pc
Para hacer la carga de la Working Key se tiene que enviar un comando de Tipo LWK con el siguiente formato.

STX 02

Comando LWK 4C 57 4B

TipoLong (bytes) HEX(8/16) 00 10

Llave Llave que se cargara B0 54 82 2F A3 3B 53 C2 3F D2 34 69 D3 C5 B1 A6

ETX LRC

03

B2

Este es el ejemplo de carga de llave:

02 4C 57 4B 00 10 B0 54 82 2F A3 3B 53 C2 3F D2 34 69 D3 C5 B1 A6 03 B2

Pin Pad
EL Pin Pad envia la respuesta de la carga de llave ACK 06 STX 02 Comando LWK 4C 57 4B TipoLong (bytes) HEX(8/16) 00 01 Respuesta 00 ETX LRC 03 B2

06 02 4C 57 4B 00 01 00 03 52

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 6 / 14

Diseo de aplicacin

4 Alta de Pin
Pc
Para dar de alta el PIN primero se solicita la lectura de tarjeta.

STX 02

Comando IC0 49 43 30

TipoLong (bytes) HEX(8/16) 00 0A

Mensaje

ETX LRC 03 45

Mensaje que mostrara en el display (LEER BANDA) 4C 45 45 52 20 42 41 4E 44 41

Este es el ejemplo del mensaje de lectura de Banda:

02 49 43 30 00 0A 4C 45 45 52 20 42 41 4E 44 41 03 45

Pin Pad
-

Retorna informacin de la transaccin iniciada

Campo Descripcin 1 Status de la operacin

TipoLong (bytes) BCD(1)

Ejemplo 00 Sin error 06 Informacin recuperada por banda magntica 99 Error desconocido 06 13 47 37 01 18 34 66 40 46 D1 30 52 01 00 00 00 22 00 00 0F FF

Track2Data El primer byte es la longitud Track 1 Data El primer byte es la longitud

HEX(21)

AN(81)

43 42 34 37 33 37 30 31 31 38 33 34 36 36 34 30 34 36 5E 41 42 52 41 48 41 4D 20 44 45 20 4C 41 20 43 52 55 5A 20 52 20 5E 31 33 30 35 32 30 31 30 30 30 30 30 30 30 30 30 30 30 30 32 32 30 30 30 30 30 30 00 00 00 00 00 00 00 00 00 00 00 00 00

06 02 49 43 30 00 67 06 13 47 37 01 18 34 66 40 46 D1 30 52 01 00 00 00 22 00 00 0F FF 43 42 34 37 33 37 30 31 31 38 33 34 36 36 34 30 34 36 5E 41 42 52 41 48 41 4D 20 44 45 20 4C 41 20 43 52 55 5A 20 52 20 5E 31 33 30 35 32 30 31 30 30 30 30 30 30 30 30 30 30 30 30 32 32 30 30 30 30 30 30 00 00 00 00 00 00 00 00 00 00 00 00 00 03 19

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 7 / 14

Diseo de aplicacin

Pc
MENSAJE INGRESAR NUEVO PIN PIN (request) Solicita la captura del nuevo PIN y genera el correspondiente Pinblock de acuerdo a las siguientes condiciones:
Cargar previamente el juego de llaves MKey y WKey. Esta carga ser en la posicin 0 del pinpad. El mensaje ms reciente recibido en el pinpad debe corresponder a un comando IC0 que haya recuperado los datos de la lectura de banda sin error o un mensaje PIN para una recaptura.

STX

Comand o PIN 50 49 4E

TipoLong (bytes) HEX(8/16) 00 0A

Mensaje Mensaje que mostrara en el display ( INGRESE NUEVO PIN) 49 4E 47 52 45 53 45 20 4E 55 45 56 4F 20 50 49 4E

ETX LRC

02

03

14

01 50 49 4E 00 11 49 4E 47 52 45 53 45 20 4E 55 45 56 4F 20 50 49 4E 03 14

MENSAJE PIN (answer) Retorna el Pinblock de la captura de PIN efectuada con base a los datos de lectura de banda recuperados del comando IC0 anterior.
Campo 1 Descripcin Status de operacin TipoLong (bytes) BCD(1) Ejemplo 00 03 11 12 13 14 16 PIN capturado Operacin cancelada Falta cargar llave para cifrado de PIN No se captur PIN Error en modulo de seguridad Tiempo de captura excedido Error en secuencia (mensaje anterior distinto a IC0/PIN)

2 Ejemplo:

Pinblock generado

HEX(8)

18 8F AF FA EF 9C 6F B1

06 02 50 49 4E 00 09 00 18 8F AF FA EF 9C 6F B1 03 32

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 8 / 14

Diseo de aplicacin

Pc
STX

MENSAJE CONFIRMAR PIN (request) Solicita nuevamente la captura de PIN.

Comand o PIN 50 49 4E TipoLong (bytes) HEX(8/16) 00 0D Mensaje Mensaje que mostrara en el display (CONFIRMAR PIN) 00 0D 43 4F 4E 46 49 52 4D 41 52 20 50 49 4E ETX LRC

02

03

6F

02 50 49 4E 00 0D 43 4F 4E 46 49 52 4D 41 52 20 50 49 4E 03 6F

MENSAJE PIN (answer) Retorna el Pinblock de la captura de PIN efectuada con base a los datos de lectura de banda recuperados del comando IC0 anterior.
Campo 1 Descripcin Status de operacin TipoLong (bytes) BCD(1) Ejemplo 00 03 11 12 13 14 16 PIN capturado Operacin cancelada Falta cargar llave para cifrado de PIN No se captur PIN Error en modulo de seguridad Tiempo de captura excedido Error en secuencia (mensaje anterior distinto a IC0/PIN)

2 Ejemplo:

Pinblock generado

HEX(8)

18 8F AF FA EF 9C 6F B1

06 02 50 49 4E 00 09 00 F4 57 10 6C F5 FC 8B 6B 03 6B

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 9 / 14

Diseo de aplicacin

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 10 / 14

Diseo de aplicacin

5 Cambio de Pin
Pc
Para hacer cambio de el PIN primero se solicita la lectura de tarjeta. STX Comand o IC0 49 43 30 TipoMensaje Long (bytes) HEX(8/16) 00 0A ETX LRC

02

Mensaje que mostrara en el display (LEER BANDA) 4C 45 45 52 20 42 41 4E 44 41

03

45

Este es el ejemplo del mensaje de lectura de Banda:

02 49 43 30 00 0A 4C 45 45 52 20 42 41 4E 44 41 03 45

Pin Pad
Retorna informacin de la transaccin iniciada

Campo Descripcin 1 Status de la operacin

TipoLong (bytes) BCD(1)

Ejemplo 03 Sin error 06 Informacin recuperada por banda magntica 99 Error desconocido 06 13 47 37 01 18 34 66 40 46 D1 30 52 01 00 00 00 22 00 00 0F FF

Track2Data El primer byte es la longitud Track 1 Data El primer byte es la longitud

HEX(21)

AN(81)

43 42 34 37 33 37 30 31 31 38 33 34 36 36 34 30 34 36 5E 41 42 52 41 48 41 4D 20 44 45 20 4C 41 20 43 52 55 5A 20 52 20 5E 31 33 30 35 32 30 31 30 30 30 30 30 30 30 30 30 30 30 30 32 32 30 30 30 30 30 30 00 00 00 00 00 00 00 00 00 00 00 00 00

06 02 49 43 30 00 67 06 13 47 37 01 18 34 66 40 46 D1 30 52 01 00 00 00 22 00 00 0F FF 43 42 34 37 33 37 30 31 31 38 33 34 36 36 34 30 34 36 5E 41 42 52 41 48 41 4D 20 44 45 20 4C 41 20 43 52 55 5A 20 52 20 5E 31 33 30 35 32 30 31 30 30 30 30 30 30 30 30 30 30 30 30 32 32 30 30 30 30 30 30 00 00 00 00 00 00 00 00 00 00 00 00 00 03 19

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 11 / 14

Diseo de aplicacin

Pc
MENSAJE SOLICITAR PIN (request) Solicita la captura de PIN y genera el correspondiente
Pinblock de acuerdo a las siguientes condiciones: Cargar previamente el juego de llaves MKey y WKey. Esta carga ser en la posicin 0 del pinpad. El mensaje ms reciente recibido en el pinpad debe corresponder a un comando IC0 que haya recuperado los datos de la lectura de banda sin error o un mensaje PIN para una recaptura. Comand o PIN 50 49 4E TipoLong (bytes) HEX(8/16) 00 0A Mensaje Mensaje que mostrara en el display (INGRESE PIN) 49 4E 47 52 45 53 45 20 50 49 4E ETX LRC

STX

02

03

45

02 50 49 4E 00 0A 49 4E 47 52 45 53 45 20 50 49 4E 03 45

MENSAJE PIN (answer) Retorna el Pinblock de la captura de PIN efectuada con base a los datos de lectura de banda recuperados del comando IC0 anterior.
Campo 1 Descripcin Status de operacin TipoLong (bytes) BCD(1) Ejemplo 00 03 11 12 13 14 16 PIN capturado Operacin cancelada Falta cargar llave para cifrado de PIN No se captur PIN Error en modulo de seguridad Tiempo de captura excedido Error en secuencia (mensaje anterior distinto a IC0/PIN)

2 Ejemplo:

Pinblock generado

HEX(8)

18 8F AF FA EF 9C 6F B1

06 02 50 49 4E 00 09 00 18 8F AF FA EF 9C 6F B1 03 32

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 12 / 14

Diseo de aplicacin

Pc
STX

MENSAJE INGRESE NUEVO PIN (request) Solicita la captura del nuevo PIN.
Comand o PIN 50 49 4E TipoLong (bytes) HEX(8/16) 00 11 Mensaje Mensaje que mostrara en el display (INGRESE NUEVO PIN) 49 4E 47 52 45 53 45 20 4E 55 45 56 4F 20 50 49 4E ETX LRC

02

03

14

02 50 49 4E 00 11 49 4E 47 52 45 53 45 20 4E 55 45 56 4F 20 50 49 4E 03 14

MENSAJE PIN (answer) Retorna el Pinblock de la captura de PIN efectuada con base a los datos de lectura de banda recuperados del comando IC0 anterior.
Campo 1 Descripcin Status de operacin TipoLong (bytes) BCD(1) Ejemplo 00 03 11 12 13 14 16 PIN capturado Operacin cancelada Falta cargar llave para cifrado de PIN No se captur PIN Error en modulo de seguridad Tiempo de captura excedido Error en secuencia (mensaje anterior distinto a IC0/PIN)

2 Ejemplo:

Pinblock generado

HEX(8)

18 8F AF FA EF 9C 6F B1

06 02 50 49 4E 00 09 00 F4 57 10 6C F5 FC 8B 6B 03 6B

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 13 / 14

Diseo de aplicacin

Pc
STX

MENSAJE CONFIRMAR PIN (request) Solicita nuevamente la captura de PIN.

Comand o PIN 50 49 4E TipoLong (bytes) HEX(8/16) 00 0D Mensaje Mensaje que mostrara en el display (CONFIRMAR PIN) 00 0D 43 4F 4E 46 49 52 4D 41 52 20 50 49 4E ETX LRC

02

03

6F

02 50 49 4E 00 0D 43 4F 4E 46 49 52 4D 41 52 20 50 49 4E 03 6F

MENSAJE PIN (answer) Retorna el Pinblock de la captura de PIN efectuada con base a los datos de lectura de banda recuperados del comando IC0 anterior.
Campo 1 Descripcin Status de operacin TipoLong (bytes) BCD(1) Ejemplo 00 03 11 12 13 14 16 PIN capturado Operacin cancelada Falta cargar llave para cifrado de PIN No se captur PIN Error en modulo de seguridad Tiempo de captura excedido Error en secuencia (mensaje anterior distinto a IC0/PIN)

2 Ejemplo:

Pinblock generado

HEX(8)

18 8F AF FA EF 9C 6F B1

06 02 50 49 4E 00 09 00 F4 57 10 6C F5 FC 8B 6B 03 6B

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.

Ttulo: Pinpad Ingenico

No.: SUC-ING-001 Versin: 1.00S Fecha: 21-Nov-2012 Pag.: 14 / 14

Diseo de aplicacin

Documento

001

Este documento y la informacin contenida en l son propiedad de Ingenico. Prohibida su reproduccin y difusin parcial o total, por cualquier medio sin autorizacin previa y por escrito de Ingenico.