IDTECH Kiosk III Sdk Manual
  1. Manuals
  2. Brands
  3. IDTECH Manuals
  4. Card Reader
  5. Kiosk III
  6. Sdk manual

IDTECH Kiosk III Sdk Manual

Windows sdk
Hide thumbs Also See for Kiosk III:
Table of Contents

Advertisement

Quick Links

IDTech Windows SDK Guide
for Kiosk III/IV
#80136501-001
Rev. A

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Kiosk III and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for IDTECH Kiosk III

Summary of Contents for IDTECH Kiosk III

  • Page 1 IDTech Windows SDK Guide for Kiosk III/IV #80136501-001 Rev. A...
  • Page 2 Revision History Revision Description and Reason for Change Date Initial Release - Manual;User;MiniSmartII;SDK;Win 1/12/2016 Added Kiosk IV Reference 6/20/2018 #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 3: Table Of Contents

    CONTENTS Contents IDTech Windows SDK Reference Guide for Kiosk III/IV Important Security Notice Applicability ..........
  • Page 4 ........#80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 5 ........14.2.2.35 device_setPollMode(byte mode) ......IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 6 ....... . . #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 7 ........IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 8 ........Index #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 9 IDTech Windows SDK Reference Guide for Kiosk III/IV IDTechSDK.dll is a Windows dynamic link library that will be provided by IDTech as the main interface between Windows Form (WinForms) the Kiosk III/IV and payment processing solutions. The purpose of this document is to describe the requirements of the API as well as the interface definitions and requirements needed for a WinForms application wishing to deploy with the payment application.
  • Page 10 IDTech Windows SDK Reference Guide for Kiosk III/IV • Main Transaction Commands • Sending Direct Commands • EMV Tag Reference • Enumeration Reference • Error Code Reference • LCD Foreign Language Mapping Table #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 11: Important Security Notice

    Windows XP, you are required to turn off Windows XP System Restore Points. 2.2 What Does PA-DSS Mean to You? The following table provides opening points to cover in any discussion with merchants on data storage. IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...

  • Page 12: Third Party Applications

    2.4 PA-DSS Guidelines The following PA-DSS Guidelines are being provided by IDTech as a convenience to its customers. Customers should not rely on these PA-DSS Guidelines, but should instead always refer to the most recent PCI DSS Program Guide published by PCI SSC.
  • Page 13 2.3 Render PAN, at a minimum, unreadable anywhere it is stored, (including data on portable digital media, backup media, and in logs) by using any of the following approaches: • One-way hashes based on strong cryptography with associated key management processes and procedures • Truncation IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 14 PCI Data Security Standard Requirement 10.1 4.2 Payment application must implement an automated audit trail to track and monitor access. PCI Data Security Standard Requirements 10.2 and 10.3 5. Develop secure payment applications #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 15 • Management sign-off by appropriate parties • Testing functionality to verify the new change(s) does not adversely impact the security of the system. Remove all testing configurations, samples, and data before finalizing the product for production. IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 16 10. Facilitate secure remote software updates 10.1 If payment application updates are delivered securely via remote access into customers systems, software vendors must tell customers to turn on remote-access technologies only when needed for downloads from vendor #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 17: More Information

    2.5 More Information IDTech Systems, Inc. highly recommends that merchants contact the card association(s) or their processing com- pany and find out exactly what they mandate and/or recommend. Doing so may help merchants protect themselves from fines and fraud.
  • Page 18 Important Security Notice • http://www.pcisecuritystandards.org • http://www.visa.com/cisp • http://www.sans.org/resources • http://www.microsoft.com/security/default.asp • https://sdp.mastercardintl.com/ • http://www.americanexpress.com/merchantspecs CAPN questions: capninfocenter@aexp.com #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 19: Sending Direct Commands

    Sending Direct Commands The main purpose of IDTech .dll for Kiosk III/IV is to expedite integration to the device by providing the connectivity and communication protocols. It also provides the main functions to get device info, perform Tap transactions, and to modify terminal configuration data files.

  • Page 20: Main Transaction Commands

    Methods for AID management. When setting the AID, you pass tags in TLV format. When retrieving AID, you can receive the results as tags in TLV format. When retrieving the AID list, the list of AID Names/length can be retrieved from the 2 dimensional byte array #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 21 When specifying a CAPK to retrieve or remove, you populate the name in the byte[] parameter. When retrieving the CAPK list, the list of RID/Index can be retrieved from the ordered byte stream, 6 bytes each, bytes 1-5 RID, byte 6 index IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...

  • Page 22: Connecting To Kiosk Iii/Iv

    • Parity: None To inform the SDK you are using the Serial Interface of the Kiosk III, you would execute the following command during program initialization to establish a connection by passing the correct COM port number. In the following example, we are connecting to COM1 SRED device: IDT_KioskIII.useSerialPort(1, true);...

  • Page 23: Core Implementation: Winforms

    Chapter 6 Core Implementation: WinForms IDTechSDK.dll includes class libraries to interface with the Kiosk III/IV. This guide assume a fair understanding of Visual Studio 2013+, C# and general Windows programming knowledge. 6.1 Integrating with IDTechSDK.dll • Import the necessary libraries •...

  • Page 24: Add Using Statements To Utilize Library

    //A connection attempt is starting for IDT_DEVICE_TYPES type break; case DeviceState.DefaultDeviceTypeChange: //The SDK is changing the default device to IDT_DEVICE_TYPES type break; case DeviceState.Connected: //A connection has been made to IDT_DEVICE_TYPES type break; #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 25: Initialize Kiosk Iii/Iv

    //Serial Connection SRED: //IDT_KioskIII.useSerialPort(1, true); 6.6 Sample Project Tutorial Using Visual Studio 2015, we will create a C# sample project that will interface with the Kiosk III and will perform the following activities: • Get firmware version • Perform CTLS Transaction...

  • Page 26: Step 1: Create New Project

    • Radio buttons for USB and COM selection. For COM selection, add a text box to specify COM port • Add buttons to execute the following functions: – Get Firmware – Start ICC Transaction – Cancel ICC Transaction • Add a text box to communicate data from the Kiosk III/IV. #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 27: Step 4: Configure The Project File

    6.6 Sample Project Tutorial • Add a text box for the log of Kiosk III/IV. 6.6.4 Step 4: Configure the project file In the start of the class file, perform the following: • Add using statements to utilize library • set callback method and initialize KioskIII singleton object in the class initializer. Reference:...

  • Page 28: Step 5: Configure Callback To Receive Important Sdk Data (Messages,Log Info And Transaction Results)

    SetOutputText("Callback:TransactionData n"); displayCardData(cardData); break; case DeviceState.DataReceived: //Low-level data received for IDT_DEVICE_TYPES type SetOutputTextLog( " IN: " + Common.getHexStringFromBytes(data)); break; case DeviceState.DataSent: //Low-level data sent for IDT_DEVICE_TYPES type SetOutputTextLog(" OUT: " + Common.getHexStringFromBytes(data)); #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 29 " r n"; (cardData.msr_track2Length > 0) text += "Track 2: " + cardData.msr_track2 + " r n"; (cardData.msr_encTrack2 != null) text += "Track 2 Encrypted: " + Common.getHexStringFromBytes(cardData.msr_encTrack2) + " r n"; IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 30 += (cardData.isCTLS ? "TRUE" : "FALSE") + " r n"; (cardData.Event == EVENT_TRANSACTION_DATA_Types.EVENT_TRANSACTION_DATA_EMV_DATA) (!cardData.isCTLS) text += "Capture Encrypt Type: " + ((cardData.emv_encryptionMode == EMV_ENCRYPTION_MODE.EMV_ENCRYPTION_MODE_TDES) ? "TDES" : "AES") + " r n"; switch (cardData.emv_resultCode) #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 31 // InvokeRequired required compares the thread ID of the // calling thread to the thread ID of the creating thread. // If these threads are different, it returns true. (logOutput.InvokeRequired) SetTextCallback d = SetTextCallback(SetOutputTextLog); IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 32 Core Implementation: WinForms Invoke(d, object[] { text }); else { logOutput.AppendText(text + " r n"); } catch (Exception ex) System.Diagnostics.Debug.WriteLine("Exception: " + ex); #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 33 ERREUR DE TR ERROR PROCE ING_ERROR RROR AITE SANDO MSG_USE_MAG USE MAGSTRIPE USAGE MAGST USO DE MAGST STRIPE RIPE RIPE MSG_TRY_AGAIN TRY AGAIN REESSAYER VUELV INTENTA MSG_ONLINE GO ONLINE GO LIGNE GO LINEA IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 34 GET PIN FAIL GET PIN FAIL OBTENER PIN F FAIL MSG_NOKEY_G NO KEY GET PIN NO KEY GET PIN NO CLAVE GET ET_PIN MSG_CANCELL CANCELLED ANNULE CANCELADO MSG_LAST_PIN LAST PIN TRY _TRY #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 35 "Sub-Command not Allowed"; case 0X0D0D: return "Buffer Overflow (Data Length too large for reader buffer)"; case 0X0D0E: return "User Interface Event"; case 0X0D11: return "Communication type not supported, VT-1, burst, etc."; IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 36 "Device is suspend (MKSK suspend or press password suspend)."; case 0x7300: return "PIN DUKPT is STOP (21 bit 1)."; case 0x7400: return "Device is Busy."; case 0xE100: return "Can not enter sleep mode"; #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 37 "INVALID ARG"; case 0x1002: return "FILE_OPEN_FAILED"; case 0x1003: return "FILE OPERATION_FAILED"; case 0x2001: return "MEMORY_NOT_ENOUGH"; case 0x3002: return "SMARTCARD_FAIL"; case 0x3003: return "SMARTCARD_INIT_FAILED"; case 0x3004: return "FALLBACK_SITUATION"; case 0x3005: return "SMARTCARD_ABSENT"; IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 38 "CM100 Parameter Error"; case 0xBBE2: return "CM100 Low Output Buffer"; case 0xBBE3: return "CM100 Card Not Found"; case 0xBBE4: return "CM100 Collision Card Exists"; case 0xBBE5: return "CM100 Too Many Cards Exist"; #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 39 0X9062: return "Any hardware problems"; case 0X9070: return "ICC communication timeout"; case 0X9071: return "ICC data error (such check sum error)"; case 0X9072: return "Smart Card not powered up"; return ""; IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 40 EMV_RESULT_CODE_GO_ONLINE = 4, EMV_RESULT_CODE_CALL_YOUR_BANK = 5, EMV_RESULT_CODE_NOT_ACCEPTED = 6, EMV_RESULT_CODE_FALLBACK_TO_MSR = 7, EMV_RESULT_CODE_TIMEOUT = 8, EMV_RESULT_CODE_GO_ONLINE_CTLS = 9, EMV_RESULT_CODE_AUTHENTICATE_TRANSACTION = 0x0010, EMV_RESULT_CODE_SWIPE_NON_ICC = 17, EMV_RESULT_CODE_CTLS_TWO_CARDS = 0x7A, EMV_RESULT_CODE_CTLS_TERMINATE = 0x7E, EMV_RESULT_CODE_CTLS_TERMINATE_TRY_ANOTHER = 0x7D, EMV_RESULT_CODE_UNABLE_TO_REACH_HOST #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 41 IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 42 File Control Information (FCI) Template READ RECORD Response Message Template Issuer Script Template 1 Issuer Script Template 2 Directory Discretionary Template Response Message Template Format 2 Response Message Template Format 1 Amount, Authorised (Binary) #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 43 Last Online Application Transaction Counter (ATC) Register 9F14 Lower Consecutive Offline Limit 9F15 Merchant Category Code 9F16 Merchant Identifier 9F17 Personal Identification Number (PIN) Try Counter 9F18 Issuer Script Identifier 9F19 Deleted (see 9F49) 9F1A Terminal Country Code IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 44 9F4A Static Data Authentication Tag List (SDA) 9F4B Signed Dynamic Application Data (SDAD) 9F4C ICC Dynamic Number 9F4D Log Entry 9F4E Merchant Name and Location 9F4F Log Format 9F50 Offline Accumulator Balance #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 45 Card Authentication Related Data 9F69 UDOL 9F6A Unpredictable Number (Numeric) 9F6B Card CVM Limit 9F6B Track 2 Data 9F6C Card Transaction Qualifiers (CTQ) 9F6D VLP Reset Threshold 9F6D Mag-stripe Application Version Number (Reader) IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 46 CDOL 1 Related Data Length Card risk management country code Card risk management currency code Lower cummulative offline transaction amount Upper cumulative offline transaction amount Card Issuer Action Code (PayPass) – Default #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 47 FF7A User Experience Suite FF7B ViVOtech Proprietary Suite FF7C VIUDS Scheme IDs Supported FF7D VIUDS Scheme ID Selection Criteria FFE0 Registered Application Provider Identifier (RID) FFE1 Partial Selection Allowed FFE2 Application Flow IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 48 DFEE27 MSR Control FFEE01 ViVOpay TLV Group Tag FFEE02 ViVOpay Pre-PPSE Special Flow Group Tag FFEE03 ViVOpay Post-PPSE Special Flow Group Tag FFEE04 M/Chip3 Intermediate Message Data FFEE04 ViVOpay MChip Group Status #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 49 FFEE10 ViVOpay MChip Group Tag FFEE11 ViVOpay Discover Group Tag FFEE12 KSN of Account DUKPT Key FFEE13 Track 1 Data FFEE14 Track 2 Data FFEE1C Unpredictable Number Range FFEE1D Sensitive Data Mask IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...

  • Page 50: Namespace Index

    ..........#80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 51: Class Index

    ........IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...

  • Page 52: Namespace Documentation

    EMV_RESULT_CODE_GO_ONLINE = 4, EMV_RESULT_CODE_CALL_YOUR_BANK = 5, EMV_RESU LT_CODE_NOT_ACCEPTED = 6, EMV_RESULT_CODE_FALLBACK_TO_MSR = 7, EMV_RESULT_CODE_TIMEOUT = 8, EMV_RESULT_CODE_GO_ONLINE_CTLS = 9, EMV_RESULT_ CODE_FAILED = 10, EMV_RESULT_CODE_AUTHENTICATE_TRANSACTION = 0x0010, EMV_RESULT_CODE_TRANSACTION_CANCELED = 0x0012, EMV_RESULT_CODE_SWIPE_NON_I CC = 0x11, EMV_RESULT_CODE_CTLS_TWO_CARDS = 0x7A, EMV_RESULT_CODE_CTLS_TERMI #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 53: Enumeration Type Documentation

    EMV_RESULT_CODE_CVM_TAG_8E_MISSING = 0x6003, EMV_RESULT_CODE_CVM_TAG_8E_ FORMAT_ERROR = 0x6004, EMV_RESULT_CODE_CVM_CODE_IS_NOT_SUPPORTED = 0x6005, EMV_RESULT_CODE_CVM_COND_CODE_IS_NOT_SUPPORTED = 0x6006, EMV_RESULT_CODE_CVM_NO_MORE = 0x6007, EMV_RESULT_CODE_PIN_BYPASSED_BEFORE = 0x6008, EMV_RESULT_CODE_UNKONWN = 0xffff } 13.1.1 Enumeration Type Documentation 13.1.1.1 enum IDTechSDK.CTLS_APPLICATION [strong] Define CTLS_APPLICATION. IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...

  • Page 54: Emv_Callback_Type

    Namespace Documentation 13.1.1.2 enum IDTechSDK.EMV_CALLBACK_TYPE [strong] Define EMV_CALLBACK_TYPES. 13.1.1.3 enum IDTechSDK.EMV_LCD_DISPLAY_MODE [strong] Define EMV_LCD_DISPLAY_MODE. 13.1.1.4 enum IDTechSDK.EMV_PIN_MODE [strong] Define EMV_PIN_MODE. 13.1.1.5 enum IDTechSDK.EMV_RESULT_CODE [strong] Define EMV_PIN_MODE. #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 55: Class Documentation

    14.1.2 Member Data Documentation 14.1.2.1 EMV_CALLBACK_TYPE IDTechSDK.EMV_Callback.callbackType Callback Type. 1- EMV_CALLBACK_TYPE_LCD: LCD Display Hardware Event 2- EMV_CALLBACK_TYPE_PINPAD: Pinpad Hardware Event 3- EMV_CALLBACK_MSR: MSR Hardware Event 14.1.2.2 byte [ ] IDTechSDK.EMV_Callback.language Message Language 2 Bytes IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...

  • Page 56: Lcd_Backlighttimeout

    •“Menu Display” : character in the range of 0x20 – 0x7f, Maximum 16 characters • “Language Menu Display” : 2 bytes Language ID EN - English (default) ES - Spanish ZH - Chinese FR – French 14.1.2.8 bool IDTechSDK.EMV_Callback.maskEntry Mask Entry If True, keypad entry should be masked with ' ' #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 57: Msr_Displaymessage

    (ref byte[ ][ ] response) • RETURN_CODE device_sendDataCommand (string cmd, bool calcLRC, ref byte[ ] response) • RETURN_CODE device_sendDataCommand_ext (string cmd, bool calcLRC, ref byte[ ] response, int timeout, bool noResponse) IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 58 • static void setCallback (CallBack my_Callback) • static void setCallback (IntPtr my_Callback, SynchronizationContext context) • static String SDK_Version • static RETURN_CODE device_updateDeviceFirmware (byte[ ] firmwareData) Properties • static IDT_KioskIII SharedController [get] #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

  • Page 59: Detailed Description

    • - Bit 7 = Touch ID Required (1=on, 0 = off) • - Bit 6 = RFU • - Bit 5 = RFU • - Bit 1,2,3,4 • - - 0 = Payment Terminal IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 60 CTLS groups as TLV bytes Returns RETURN_CODE: Values can be parsed with errorCode.getErrorString() 14.2.2.5 RETURN_CODE IDTechSDK.IDT_KioskIII.ctls_getConfigurationGroup ( int group, ref byte[ ] tlv ) Get Configuration Group Retrieves the Configuration for the specified Group. #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 61 6 byte CAPK = 5 bytes RID + 1 byte INDEX Returns RETURN_CODE: Values can be parsed with errorCode.getErrorString() 14.2.2.9 RETURN_CODE IDTechSDK.IDT_KioskIII.ctls_removeConfigurationGroup ( int group ) Remove Configuration Group Removes the Configuration as specified by the Group. Must not by group 0 IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 62 Retrieve Certificate Authority Public Key Retrieves the CAPK for CTLS as specified by the RID/Index passed as a parameter. Parameters capk 6 bytes CAPK = 5 bytes RID + 1 byte Index #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 63 Retrieves the Terminal Data for CTLS. This is configuration group 0 (Tag FFEE - FFEE0100). The terminal data can also be retrieved by ctls_getConfigurationGroup(0). Parameters Response returned as a TLV Returns RETURN_CODE: Values can be parsed with errorCode.getErrorString() IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 64 Sets the Configuration Group for CTLS as specified by the TLV data Parameters Configuration Group Data in TLV format The first tag of the TLV data must be the group number (FFE4). A second tag must exist #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 65 DF010101 9F22 = two bytes = ApplePay Terminal Applicaiton Version Number. Hard defined as 0100 for now. (required) 9F26 = four bytes = ApplePay Terminal Capabilities Information (required) • Byte 1 = RFU • Byte 2 = Terminal Type IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 66 Transaction date. If null, uses current terminal date. 3 bytes compressed numeric YYMMDD (tag value 9A). time Transaction time. If null, uses current terminal time. 3 bytes compressed numeric HHMMSS (tag value 9F21). #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 67 • Byte 3 = RFU • Byte 4 = Terminal Mode • - 0 = ApplePay VAS OR ApplePay • - 1 = ApplePay VAS AND ApplePay • - 2 = ApplePay VAS ONLY IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 68 14.2.2.23 RETURN_CODE IDTechSDK.IDT_KioskIII.device_enablePassThrough ( bool enablePassThrough ) Enable Pass Through Enables Pass Through Mode for direct communication with L1 interface (power on icc, send apdu, etc). Parameters enablePassThrough true = pass through ON, false = pass through OFF #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 69 RETURN_CODE: Values can be parsed with errorCode.getErrorString(). When no data is available, return code = RETURN_CODE_NO_DATA_AVAILABLE 14.2.2.27 RETURN_CODE IDTechSDK.IDT_KioskIII.device_pingDevice ( ) Ping Device Pings the reader. If connected, returns success. Otherwise, returns timeout. IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 70 Timeout value waiting for response, in milliseconds (1000 = 1 second) noResponse if TRUE, this will not wait for a response and immediately return SUCCESS calcITP TRUE , this will wrap command as ITP with start/end/lrc: '{STX} data {ETX}{CheckLRC}' #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 71 RETURN_CODE: Values can be parsed with errorCode.getErrorString() 14.2.2.33 RETURN_CODE IDTechSDK.IDT_KioskIII.device_setBurstMode ( byte mode ) Send Burst Mode Sets the burst mode forthe device. Parameters mode 0 = OFF, 1 = Always On, 2 = Auto Exit IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 72 RETURN_CODE: Values can be parsed with errorCode.getErrorString() 14.2.2.36 RETURN_CODE IDTechSDK.IDT_KioskIII.device_startRKI ( ) Start Legacy Remote Key Injection Starts a remote key injection request with IDTech RKI Legacy servers. Returns RETURN_CODE: Values can be parsed with device_getResponseCodeString 14.2.2.37 RETURN_CODE IDTechSDK.IDT_KioskIII.device_startTransaction ( double amount, double amtOther, int exponent,...
  • Page 73 • - Bit 2 : 1 = VAS Beeps, 0 = No VAS Beeps • - Bit 3 : 1 = Silent Comm Error, 2 = EMEA Comm Error • - Bit 4-8 : RFU IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 74 Class Documentation 14.2.2.38 RETURN_CODE IDTechSDK.IDT_KioskIII.device_SymmetricRKI ( ) Start Remote Key Injection Starts a remote key injection request with IDTech Symmetric RKI servers. Set/Get RKI url with IDT_Device.RKI_ URL. Returns RETURN_CODE: Values can be parsed with device_getResponseCodeString 14.2.2.39 static RETURN_CODE IDTechSDK.IDT_KioskIII.device_updateDeviceFirmware ( byte[ ] firmwareData )
  • Page 75 14.2.2.41 static String IDTechSDK.IDT_KioskIII.SDK_Version ( ) [static] SDK Version • All Devices Returns the current version of SDK Returns Framework version 14.2.2.42 static void IDTechSDK.IDT_KioskIII.setCallback ( CallBack my_Callback ) [static] Set Callback Sets the class callback IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 76 14.2.2.45 static bool IDTechSDK.IDT_KioskIII.useSerialPort ( int port ) [static] Use Serial Port Interface Instructs SDK to attempt to use the Serial Port for communication with Kiosk III/IV using default baud rate Parameters port Serial Port to use. Example COM1 = 1.
  • Page 77 14.3 IDTechSDK.IDTCryptoData Class Reference 14.2.2.47 static bool IDTechSDK.IDT_KioskIII.useUSB ( ) [static] Use USB Interface Instructs SDK to attempt to use USB for communication with Kiosk III/IV 14.2.3 Property Documentation 14.2.3.1 IDT_KioskIII IDTechSDK.IDT_KioskIII.SharedController [static] [get] Singleton Instance Establishes an singleton instance of IDT_KioskIII class.
  • Page 78 TRUE = Decrypt Data. FALSE = Encrypt Data 14.3.2.10 bool IDTechSDK.IDTCryptoData.isTDES TRUE = Use TDES. FALSE = Use AES 14.3.2.11 int IDTechSDK.IDTCryptoData.keyVariant 0 = Use Data Variant. 1 = Use PIN Variant. 2 = Use MAC Variant #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 79 The documentation for this class was generated from the following file: • Source/IDT_Transactions.cs 14.4 IDTechSDK.IDTTransactionData Class Reference Static Public Member Functions • static void setTransactionAttributes (byte attribute, ref IDTTransactionData data, byte attribute2=0) IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 80 • byte[ ] • byte[ ] macKSN • bool hasMACVerificationData • TRANS_ERROR_CODE emv_transaction_Error_Code • RF_STATE emv_RF_State • EXTENDED_STATUS_CODES emv_ESC • CEMV_APP_ERROR_FN emv_appErrorFn • CEMV_APP_ERROR_STATE emv_appErrorState • byte[ ] captured_PAN • byte[ ] captured_KSN #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 81 This initial vector is used for all encryptions in this command. If encryption is off thisfield will be filled with zeros (00h). 14.4.2.6 byte [ ] IDTechSDK.IDTTransactionData.captured_KSN KSN used to encrypt manually captured PAN from keyed input 14.4.2.7 string IDTechSDK.IDTTransactionData.captured_lastPANDigits Last plaintext PAN digits IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 82 Get the encrypted type for EMV,please see CAPTURE_ENCRYPT_TYPE for more information. CAPTURE_ENCRYPT_TYPE_UNKNOWN; CAPTURE_ENCRYPT_TYPE_TDES; CAPTURE_ENCRYPT_TYPE_AES; CAPTURE_ENCRYPT_TYPE_NONE; CAPTURE_ENCRYPT_TRANS_ARMOR_PKI; CAPTURE_ENCRYPT_VOLTAGE; CAPTURE_ENCRYPT_VISA_FPE; CAPTURE_ENCRYPT_VERIFONE_FPE; CAPTURE_ENCRYPT_DESJARDIN 14.4.2.14 CTLS_APPLICATION IDTechSDK.IDTTransactionData.ctlsApplication CTLS Application 14.4.2.15 String IDTechSDK.IDTTransactionData.device_RSN Get the Reader Serial Number. #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 83 RF_State (select AR products) 14.4.2.27 int IDTechSDK.IDTTransactionData.emv_rfStateCode For some Error Codes, the RF State Code indicates the exact Reader-Card command that failed. This helps determine the exact place where the failure occurred. IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 84 Bit2:1-track3 data error; Bit3:1-track1 encrypted data error; Bit4:1-track2 encrypted data error; Bit5:1-track3 encrypted data error; Bit6:1-KSN error; 14.4.2.37 CAPTURE_ENCODE_TYPE IDTechSDK.IDTTransactionData.msr_cardType Get the swiped card type,please see CAPTURE_ENCODE_TYPE for more information. MSR card type: #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 85 14.4.2.45 byte [ ] IDTechSDK.IDTTransactionData.msr_hashTrack3 Get the swiped card Track3 hash data. A byte array containing Track3 hash data. 14.4.2.46 KEY_VARIANT_TYPE IDTechSDK.IDTTransactionData.msr_keyVariantType KEY_VARIANT_TYPE_DATA = Data Variant key used KEY_VARIANT_TYPE_PIN = PIN Variant key used IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 86 A string containing Track3 masked data expressed as hex characters. 14.4.2.55 int IDTechSDK.IDTTransactionData.msr_track3Length Get the swiped card length of Track3 data. 14.4.2.56 EVENT_NOTIFICATION_Types IDTechSDK.IDTTransactionData.Notification Event Notification type,please see EVENT_NOTIFICATION_Types for more information. 14.4.2.57 string IDTechSDK.IDTTransactionData.pin_KeyEntry KSN for Pinblock #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 87 14.4.2.58 string IDTechSDK.IDTTransactionData.pin_KSN KSN for Pinblock 14.4.2.59 string IDTechSDK.IDTTransactionData.pin_pinblock PIN block from PINPAD 14.4.2.60 byte IDTechSDK.IDTTransactionData.SW1 14.4.2.61 byte IDTechSDK.IDTTransactionData.SW2 The documentation for this class was generated from the following file: • Source/IDT_Transactions.cs IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 88 Index IDTechSDK::IDT_KioskIII, IDTechSDK::IDTCryptoData, ctls_removeConfigurationGroup IDTechSDK::IDT_KioskIII, CTLS_APPLICATION ctls_retrieveAIDList IDTechSDK, IDTechSDK::IDT_KioskIII, callbackType ctls_retrieveApplicationData IDTechSDK::EMV_Callback, IDTechSDK::IDT_KioskIII, captureCardType ctls_retrieveCAPKList IDTechSDK::IDTTransactionData, IDTechSDK::IDT_KioskIII, captureEncryptType ctls_retrieveCAPK IDTechSDK::IDTTransactionData, IDTechSDK::IDT_KioskIII, captureEncryptTypeEMV ctls_retrieveTerminalData IDTechSDK::IDTTransactionData, IDTechSDK::IDT_KioskIII, captured_CSC ctls_setApplicationData IDTechSDK::IDTTransactionData, IDTechSDK::IDT_KioskIII, captured_Expiry ctls_setCAPK IDTechSDK::IDTTransactionData, IDTechSDK::IDT_KioskIII, captured_InitialVector ctls_setConfigurationGroup IDTechSDK::IDTTransactionData, IDTechSDK::IDT_KioskIII, captured_KSN ctls_setTerminalData IDTechSDK::IDTTransactionData, IDTechSDK::IDT_KioskIII, captured_MACKSN ctls_startTransaction...
  • Page 89 IDTechSDK::IDTTransactionData, ctls_retrieveAIDList, emv_encipheredOnlinePIN IDTechSDK::IDTTransactionData, ctls_retrieveApplicationData, emv_encryptedTags ctls_retrieveCAPKList, ctls_retrieveCAPK, IDTechSDK::IDTTransactionData, ctls_retrieveTerminalData, emv_hasAdvise IDTechSDK::IDTTransactionData, ctls_setApplicationData, emv_hasReversal ctls_setCAPK, IDTechSDK::IDTTransactionData, ctls_setConfigurationGroup, ctls_setTerminalData, emv_maskedTags IDTechSDK::IDTTransactionData, ctls_startTransaction, emv_resultCode ctls_updateBalance, IDTechSDK::IDTTransactionData, device_SymmetricRKI, emv_rfStateCode device_activateTransaction, IDTechSDK::IDTTransactionData, device_controlUserInterface, IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 90 IDTechSDK::IDTTransactionData pin_KeyEntry, captureCardType, pin_pinblock, captureEncryptType, SW1, captureEncryptTypeEMV, SW2, captured_CSC, IDTechSDK, captured_Expiry, CTLS_APPLICATION, captured_InitialVector, EMV_CALLBACK_TYPE, captured_KSN, EMV_LCD_DISPLAY_MODE, captured_MACKSN, EMV_PIN_MODE, captured_MACValue, EMV_RESULT_CODE, captured_PAN, IPEK captured_SHA256, IDTechSDK::IDTCryptoData, captured_firstPANDigits, iccPresent captured_lastPANDigits, IDTechSDK::IDTTransactionData, ctlsApplication, isCTLS #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...
  • Page 91 IDTechSDK::EMV_Callback, msr_encTrack1 pin_pinblock IDTechSDK::IDTTransactionData, IDTechSDK::IDTTransactionData, msr_encTrack2 pin_truncatedPAN IDTechSDK::IDTTransactionData, IDTechSDK::EMV_Callback, msr_encTrack3 pinBlock IDTechSDK::IDTTransactionData, IDTechSDK::IDTCryptoData, msr_errorCode IDTechSDK::IDTTransactionData, SDK_Version msr_extendedField IDTechSDK::IDT_KioskIII, IDTechSDK::IDTTransactionData, msr_hashTrack1 IDTechSDK::IDTTransactionData, IDTechSDK::IDTTransactionData, msr_hashTrack2 IDTechSDK::IDTTransactionData, IDTechSDK::IDTTransactionData, setCallback msr_hashTrack3 IDTechSDK::IDT_KioskIII, IDTechSDK::IDTTransactionData, setCommandTimeout msr_keyVariantType IDTechSDK::IDT_KioskIII, IDTech Windows SDK Guide for Kiosk III/IV #80136501-001...
  • Page 92 INDEX SharedController IDTechSDK::IDT_KioskIII, useSerialPort IDTechSDK::IDT_KioskIII, useUSB IDTechSDK::IDT_KioskIII, #80136501-001 IDTech Windows SDK Guide for Kiosk III/IV...

This manual is also suitable for:

Kiosk iv

Table of Contents