Skip to main content

Veritran Docs

[en] Get PIN

[en] This function accesses the cryptoprocessor and requests an encrypted pin. It allows the user to enter their password and encrypt it in DUKPT (Derived Unique Key Per Transaction) 3DE format for safety.

[en] Parameter Configuration

[en] This function requires you to configure a key slot number, a PAN number, an input timeout and a minimum and maximum PIN length. Refer to the Input Registers section to learn more.

[en] Function ID

[en] Register

[en] Value

110

3

[en] Input Registers

[en] Register

[en] Description

[en] Mandatory

[en] Value

390

[en] Key slot number from 0 to 99

[en] Yes

[en] 0 to 99

391

[en] PAN number (Primary Account Number on the card)

[en] Yes

[en] From 13 to 19 digits.

[en] For EMV and EMV CTLS, prompt for tag 5A with the GET_EMV_TAG_VALUE function.

392

[en] Timeout for customer input (in milliseconds)

[en] Yes

[en] 30 seconds = 30000

393

[en] Minimum PIN length

[en] Yes

[en] From 4 to 12 digits. It can't exceed the PIN's maximum length

394

[en] Maximum PIN length

[en] Yes

[en] Up to 12 digits. It can't be shorter than the PIN's minimum length

395

[en] Session key (only available if the type of key invoked is Master Session)

[en] No

[en] 32-digit hexadecimal string

[en] Output Registers

[en] Register

[en] Description

[en] Value

112

[en] Call result

000

[en] NO_ERROR

001

[en] INVALID_INPUT_PARAMETER

002

[en] INVALID_SLOT

003

[en] SLOT_HAS_NO_KEY

004

[en] KEY_NOT_STORED_IN_SLOT

005

[en] KEY_IS_NOT_MASTER_SESSION_KEY

006

[en] CANCELLED_PIN

007

[en] INVALID_KCV

290

[en] PIN block

[en] 16-digit hexadecimal string

291

[en] Keyless Signature Infrastructure (SKI). Available only if the key is DUKPT

[en] 16-digit hexadecimal string