Skip to main content

Veritran Docs

Get PIN

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.

Parameter Configuration

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.

Function ID

Register

Value

110

3

Input Registers

Register

Description

Mandatory

Value

390

Key slot number from 0 to 99

Yes

0 to 99

391

PAN number (Primary Account Number on the card)

Yes

From 13 to 19 digits.

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

392

Timeout for customer input (in milliseconds)

Yes

30 seconds = 30000

393

Minimum PIN length

Yes

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

394

Maximum PIN length

Yes

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

395

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

No

32-digit hexadecimal string

Output Registers

Register

Description

Value

112

Call result

000

NO_ERROR

001

INVALID_INPUT_PARAMETER

002

INVALID_SLOT

003

SLOT_HAS_NO_KEY

004

KEY_NOT_STORED_IN_SLOT

005

KEY_IS_NOT_MASTER_SESSION_KEY

006

CANCELLED_PIN

007

INVALID_KCV

290

PIN block

16-digit hexadecimal string

291

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

16-digit hexadecimal string