![]() |
IDTech Windows SDK Guide
3.2.4.393
API reference for Visual Studio .Net
|
Public Member Functions | |
RETURN_CODE | device_sendPAE (string command, ref string response, int timeoutstring, string ident="") |
RETURN_CODE | emv_startTransaction (double amount, double amtOther, int exponent, int type, int timeout, byte[] tags, bool forceOnline, bool isFastEMV=false, string ident="") |
RETURN_CODE | emv_authenticateTransaction (byte[] updatedTLV, string ident="") |
RETURN_CODE | emv_completeTransaction (bool commError, byte[] authCode, byte[] iad, byte[] tlvScripts, byte[] tlv, string ident="") |
RETURN_CODE | emv_callbackResponseLCD (EMV_LCD_DISPLAY_MODE type, byte selection, string ident="") |
RETURN_CODE | emv_callbackResponsePIN (EMV_PIN_MODE type, byte[] KSN, byte[] PIN, string ident="") |
RETURN_CODE | emv_callbackResponseMSR (byte[] MSR, string ident="") |
RETURN_CODE | emv_cancelTransaction (string ident="") |
RETURN_CODE | emv_getEMVKernelVersion (ref string response, string ident="") |
RETURN_CODE | emv_getEMVKernelCheckValue (ref string response, string ident="") |
RETURN_CODE | emv_getEMVConfigurationCheckValue (ref string response, string ident="") |
RETURN_CODE | emv_retrieveTransactionResult (byte[] tags, ref IDTTransactionData tlv, string ident="") |
RETURN_CODE | emv_removeApplicationData (byte[] AID, string ident="") |
RETURN_CODE | emv_removeAllApplicationData (string ident="") |
RETURN_CODE | emv_removeCAPK (byte[] capk, string ident="") |
RETURN_CODE | emv_removeAllCAPK (string ident="") |
RETURN_CODE | emv_removeCRL (byte[] crlList, string ident="") |
RETURN_CODE | emv_removeAllCRL (string ident="") |
RETURN_CODE | emv_removeTerminalData (string ident="") |
RETURN_CODE | emv_retrieveAIDList (ref byte[][] response, string ident="") |
RETURN_CODE | emv_retrieveApplicationData (byte[] AID, ref byte[] tlv, string ident="") |
RETURN_CODE | emv_retrieveCAPK (byte[] capk, ref byte[] key, string ident="") |
RETURN_CODE | emv_retrieveCAPKList (ref byte[] keys, string ident="") |
RETURN_CODE | emv_retrieveCRLList (ref byte[] list, string ident="") |
RETURN_CODE | emv_retrieveTerminalData (ref byte[] tlv, string ident="") |
RETURN_CODE | emv_setApplicationData (byte[] name, byte[] tlv, string ident="") |
RETURN_CODE | emv_setCAPK (byte[] key, string ident="") |
RETURN_CODE | emv_setCRL (byte[] list, string ident="") |
RETURN_CODE | emv_trySetTerminalData (byte[] tlv, ref byte[] rejectedTLV, ref byte[] convertedTLV, bool overwrite=false, string ident="") |
RETURN_CODE | emv_setTerminalData (byte[] tlv, string ident="") |
RETURN_CODE | emv_addTerminalData (byte[] tlv, string ident="") |
RETURN_CODE | emv_setTerminalMajorConfiguration (int configuration, string ident="") |
RETURN_CODE | config_getModelNumber (ref string response, string ident="") |
RETURN_CODE | config_getSerialNumber (ref string response, string ident="") |
bool | config_setCmdTimeOutDuration (int newTimeOut, string ident="") |
RETURN_CODE | config_setLEDController (bool firmwareControlMSRLED, bool firmwareControlICCLED=false, string ident="") |
RETURN_CODE | config_getLEDController (ref bool firmwareControlMSRLED, ref bool firmwareControlICCLED, string ident="") |
RETURN_CODE | config_setBeeperController (bool firmwareControlBeeper, string ident="") |
RETURN_CODE | config_getBeeperController (ref bool firmwareControlBeeper, string ident="") |
RETURN_CODE | device_controlLED_ICC (int controlMode, int interval, string ident="") |
RETURN_CODE | device_controlBeep (int index, int frequency, int duration, string ident="") |
RETURN_CODE | device_controlLED (byte indexLED, byte control, int intervalOn=500, int intervalOff=500, string ident="") |
RETURN_CODE | config_setEncryptionControl (bool msr, bool icc, string ident="") |
RETURN_CODE | config_getEncryptionControl (ref bool msr, ref bool icc, string ident="") |
RETURN_CODE | device_getKeyStatus (ref byte[] status, string ident="") |
RETURN_CODE | device_setDateTime (string ident="") |
RETURN_CODE | device_startRKI (string ident="") |
RETURN_CODE | device_getFirmwareVersion (ref string response, string ident="") |
string | device_getResponseCodeString (RETURN_CODE eCode) |
RETURN_CODE | device_rebootDevice (string ident="") |
RETURN_CODE | device_sendDataCommand (string cmd, bool calcLRC, ref byte[] response, string ident="") |
RETURN_CODE | device_controlLED_MSR (byte control, int intervalOn=500, int intervalOff=500, string ident="") |
RETURN_CODE | icc_enable (bool withNotification, string ident="") |
RETURN_CODE | icc_disable (string ident="") |
RETURN_CODE | icc_getFunctionStatus (ref bool enabled, ref bool withNotification, string ident="") |
RETURN_CODE | icc_exchangeAPDU (string c_APDU, ref byte[] response, string ident="") |
RETURN_CODE | icc_exchangeEncryptedAPDU (string c_APDU, ref byte[] response, string ident="") |
RETURN_CODE | icc_getAPDU_KSN (ref byte[] ksn, string ident="") |
RETURN_CODE | icc_getICCReaderStatus (ref byte status, string ident="") |
RETURN_CODE | icc_getKeyFormatForICCDUKPT (ref byte format, string ident="") |
RETURN_CODE | icc_getKeyTypeForICCDUKPT (ref byte type, string ident="") |
RETURN_CODE | icc_powerOffICC (string ident="") |
RETURN_CODE | icc_powerOnICC (ref byte[] ATR, string ident="") |
RETURN_CODE | icc_setKeyFormatForICCDUKPT (byte encryption, string ident="") |
RETURN_CODE | icc_setKeyTypeForICCDUKPT (byte encryption, string ident="") |
RETURN_CODE | msr_captureMode (bool isBufferMode, bool withNotification=false, string ident="") |
RETURN_CODE | msr_disable (string ident="") |
RETURN_CODE | msr_getFunctionStatus (ref bool enabled, ref bool isBufferMode, ref bool withNotification, string ident="") |
RETURN_CODE | msr_switchUSBInterfaceMode (bool bIsUSBKeyboardMode) |
RETURN_CODE | msr_switchUSBInterfaceMode (bool bIsUSBKeyboardMode, ref string ident) |
RETURN_CODE | msr_getClearPANID (ref byte value, string ident="") |
RETURN_CODE | msr_getExpirationMask (ref byte value, string ident="") |
RETURN_CODE | msr_getSwipeEncryption (ref byte encryption, string ident="") |
RETURN_CODE | msr_getSwipeForcedEncryptionOption (ref byte option, string ident="") |
RETURN_CODE | msr_getSwipeMaskOption (ref byte option, string ident="") |
RETURN_CODE | msr_RetrieveWhiteList (ref byte[] value, string ident="") |
RETURN_CODE | msr_getSetting (byte setting, ref byte value, string ident="") |
RETURN_CODE | msr_getSettings (byte setting, ref byte[] value, string ident="") |
RETURN_CODE | msr_setSetting (byte setting, byte value, string ident="") |
RETURN_CODE | msr_setSettings (byte setting, byte[] value, string ident="") |
RETURN_CODE | msr_setClearPANID (byte val, string ident="") |
RETURN_CODE | msr_setExpirationMask (bool mask, string ident="") |
RETURN_CODE | msr_setSwipeEncryption (byte encryption, string ident="") |
RETURN_CODE | msr_setSwipeForcedEncryptionOption (bool track1, bool track2, bool track3, bool track3card0, string ident="") |
RETURN_CODE | msr_setSwipeMaskOption (bool track1, bool track2, bool track3, string ident="") |
RETURN_CODE | msr_setWhiteList (byte[] value, byte[] MAC, string ident="") |
RETURN_CODE | msr_startMSRSwipe (int timeout, string ident="") |
RETURN_CODE | msr_cancelMSRSwipe (string ident="") |
RETURN_CODE | device_getRKIStatus (bool isProd, bool isMultiKey, ref string status, ref Dictionary< string, RKI_KEY_TYPE > keys, string ident="") |
RETURN_CODE | device_getAnyRKIStatus (bool isMultiKey, ref string status, ref Dictionary< string, RKI_KEY_TYPE > keys, string ident="") |
RETURN_CODE | device_sendConfigurationFromZip (byte[] zip, string filename, VC_OPERATION_TYPE type, bool matchFW, string ident="", bool isForeground=false) |
RETURN_CODE | device_sendConfiguration (string filename, VC_OPERATION_TYPE type, bool matchFW, string ident="", bool isForeground=false) |
RETURN_CODE | device_readConfigurationToMemory (string memo, Configs.InstallRules rules, List< Configs.DeviceCommand > cmds, string ident="", bool isForeground=false) |
RETURN_CODE | device_getConfigurationFromMemory (ref string json, string ident="") |
RETURN_CODE | device_RemoteKeyInjection (RKI_KEY_TYPE type, string keyName, string ident="", bool performOnForeground=false) |
Static Public Member Functions | |
static bool | useSerialPort (int port) |
static bool | useSerialPort (int port, int baud) |
static bool | useSerialPortLinux (string path) |
static bool | useSerialPortLinux (string path, int baud) |
static void | initSC () |
static int | getCommandTimeout (string ident="") |
static void | setCommandTimeout (int milliseconds, string ident="") |
static void | setCallback (CallBack my_Callback) |
static void | setCallback (IntPtr my_Callback, SynchronizationContext context) |
static void | emv_autoAuthenticate (bool authenticate, string ident="") |
static void | emv_autoAuthenticateTags (bool authenticate, byte[] tags, string ident="") |
static void | emv_allowFallback (bool allow, string ident="") |
static String | SDK_Version () |
Properties | |
static IDT_BTPay | SharedController [get] |
RETURN_CODE IDTechSDK.IDT_BTPay.config_getBeeperController | ( | ref bool | firmwareControlBeeper, |
string | ident = "" |
||
) |
Get the Beeper Controller Status Set the Beeper controlled Status by software or firmware
firmwareControlBeeper | true means firmware control the beeper, false means software control beeper. |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.config_getEncryptionControl | ( | ref bool | msr, |
ref bool | icc, | ||
string | ident = "" |
||
) |
Get Encryption Control
Get Encryption Control to switch status between MSR and ICC/EMV function. Following Encryption status supported:
msr |
|
icc |
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.config_getLEDController | ( | ref bool | firmwareControlMSRLED, |
ref bool | firmwareControlICCLED, | ||
string | ident = "" |
||
) |
Get the LED Controller Status Get the MSR / ICC LED controlled status by software or firmware
firmwareControlMSRLED |
|
firmwareControlICCLED |
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.config_getModelNumber | ( | ref string | response, |
string | ident = "" |
||
) |
Polls device for Model Number
@param response Returns Model Number
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.config_getSerialNumber | ( | ref string | response, |
string | ident = "" |
||
) |
Polls device for Serial Number
@param response Returns Serial Number
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.config_setBeeperController | ( | bool | firmwareControlBeeper, |
string | ident = "" |
||
) |
Set the Beeper Controller Set the Beeper controlled by software or firmware
firmwareControlBeeper | true means firmware control the beeper, false means software control beeper. |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
bool IDTechSDK.IDT_BTPay.config_setCmdTimeOutDuration | ( | int | newTimeOut, |
string | ident = "" |
||
) |
Command Acknowledgement Timout
Sets the amount of seconds to wait for an {ACK} to a command before a timeout. Responses should normally be received under one second. Default is 3 seconds
newTimeOut | Timout value. Valid range 1 - 60 seconds |
RETURN_CODE IDTechSDK.IDT_BTPay.config_setEncryptionControl | ( | bool | msr, |
bool | icc, | ||
string | ident = "" |
||
) |
Set Encryption Control
Set Encryption Control to switch status between MSR and ICC/EMV function. Following Encryption status supported:
msr |
|
icc |
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.config_setLEDController | ( | bool | firmwareControlMSRLED, |
bool | firmwareControlICCLED = false , |
||
string | ident = "" |
||
) |
Set the LED Controller Set the MSR / ICC LED controlled by software or firmware NOTE: The ICC LED always controlled by software.
firmwareControlMSRLED |
|
firmwareControlICCLED |
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_controlBeep | ( | int | index, |
int | frequency, | ||
int | duration, | ||
string | ident = "" |
||
) |
Control Beep
Controls the Beeper
index | For Augusta, must be set to 1 (only one beeper) |
frequency | Frequency, range 1000-20000 (suggest minimum 3000) |
duration | Duration, in milliseconds (range 1 - 65525) |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_controlLED | ( | byte | indexLED, |
byte | control, | ||
int | intervalOn = 500 , |
||
int | intervalOff = 500 , |
||
string | ident = "" |
||
) |
Control MSR LED
Controls the LED for the MSR
indexLED | For Augusta, must be set to 1 (MSR LED) |
control | LED Status:
|
intervalOn | Blink interval ON, in ms (Range 200 - 2000) |
intervalOff | Blink interval OFF, in ms (Range 200 - 2000) |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_controlLED_ICC | ( | int | controlMode, |
int | interval, | ||
string | ident = "" |
||
) |
Control ICC LED
Controls the LED for the ICC card slot
controlMode | 0 = off, 1 = solid, 2 = blink |
interval | Blink interval, in ms (500 = 500 ms) |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_controlLED_MSR | ( | byte | control, |
int | intervalOn = 500 , |
||
int | intervalOff = 500 , |
||
string | ident = "" |
||
) |
Control the MSR LED
Controls the MSR / ICC LED This API not recommended to control ICC LED
control |
|
intervalOn | Blink interval on time last, in ms (500 = 500 ms, valid from 200 to 2000) |
intervalOff | Blink interval off time last, in ms (500 = 500 ms, valid from 200 to 2000) |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_getAnyRKIStatus | ( | bool | isMultiKey, |
ref string | status, | ||
ref Dictionary< string, RKI_KEY_TYPE > | keys, | ||
string | ident = "" |
||
) |
Get RKI Status Polls the RKI servers to validate device RKI eligiblity. Note: if device type is known in advance (production or demo device), it is more efficient to use device_getRKIStatus instead
isMultiKey | True = MultiKey, False = SingleKey |
status | RKI status returned as a string |
keys | Returns all available keys |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_getConfigurationFromMemory | ( | ref string | json, |
string | ident = "" |
||
) |
Read Device Configuration From Memory Retrieves the ViVOconfig configuration data from memory after a successful device_readConfigurationToMemory
json | Returns the .json file data that can be saved to disk |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_getFirmwareVersion | ( | ref string | response, |
string | ident = "" |
||
) |
Polls device for Firmware Version
response | Response returned of Firmware Version |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_getKeyStatus | ( | ref byte[] | status, |
string | ident = "" |
||
) |
Get Key Status
Gets the status of loaded keys
status | when the newFormat is false, data format as follows. byte 0: PIN DUKPT Key, Does not support, always 0 byte 1: PIN Master Key, Does not support, always 0 byte 2: PIN Session Key, Does not support, always 0 byte 3: Account/MSR DUKPT Key, 1 Exists, 0 None, 0xFF STOP byte 4: Account/ICC DUKPT Key, 1 Exists, 0 None, 0xFF STOP byte 5: Admin DUKPT Key, 1 Exists, 0 None, 0xFF STOP |
when the newFormat is true, data format as follows. [Block Length] [KeyStatusBlock1] [KeyStatusBlock2] …[KeyStatusBlockN] Where: [Block Length] is 2 bytes, format is Len_L Len_H, is KeyStatusBlock Number [KeyStatusBlockX> is 4 bytes, format is [Key Index and Key Name] [key slot] [key status]: [Key Index and Key Name] is 1 byte. Please refer to following table 0x14 LCL-KEK to Encrypt Other Keys 0x02 Data encryption Key to Encrypt ICC/MSR 0x05 MAC DUKPT Key for Host-Device – MAC Verification 0x05 MTK DUKPT Key for TTK Self-Test 0x0C RKI-KEK for Remote Key Injection [key slot] is 2 bytes. Range is 0 – 9999 the MTK DUKPT Key slot is 16, the others are all 0 [key status] is 1 byte. 0 – Not Exist 1 – Exist 0xFF – (Stop. Only Valid for DUKPT Key)
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
string IDTechSDK.IDT_BTPay.device_getResponseCodeString | ( | RETURN_CODE | eCode | ) |
Get the description of response result.
eCode | the response result. |
the | string for description of response result |
RETURN_CODE IDTechSDK.IDT_BTPay.device_getRKIStatus | ( | bool | isProd, |
bool | isMultiKey, | ||
ref string | status, | ||
ref Dictionary< string, RKI_KEY_TYPE > | keys, | ||
string | ident = "" |
||
) |
Get RKI Status From Specified Server Polls the RKI server to validate device RKI eligiblity
isProd | TRUE = poll production RKI server, FALSE = poll demo RKI server |
isMultiKey | True = MultiKey, False = SingleKey |
status | RKI status returned as a string |
keys | Returns dictionary of available keys |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_readConfigurationToMemory | ( | string | memo, |
Configs.InstallRules | rules, | ||
List< Configs.DeviceCommand > | cmds, | ||
string | ident = "" , |
||
bool | isForeground = false |
||
) |
Read Device Configuration To Memory Executes a ViVOconfig read of device settings and stores the results in memory
Once a ViVOconfig read starts, all messages will be returned to the callback as DeviceState.ViVOconfig. The ViVOconfig operation is complete when the return code from a DeviceState.ViVOconfig message is one of the following values:
RETURN_CODE_SDK_VIVOCONFIG_READ_CONFIG_FAILED = Read process FAILED.
memo | Optional: populates the memo field of the captured .json file |
rules | Optional: populates the .json file with available install rules |
cmds | Optional: populates the .json file with commands to execute |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
isForeground | If TRUE, will block program until update complete. Otherwise, FALSE performs update on background. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_rebootDevice | ( | string | ident = "" | ) |
Reboot Device
Executes a command to restart the device.
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_RemoteKeyInjection | ( | RKI_KEY_TYPE | type, |
string | keyName, | ||
string | ident = "" , |
||
bool | performOnForeground = false |
||
) |
Remote Key Injection Performs a remote key injection for the device
type | Remote Key Injection Type |
keyName | Name of key (optional) |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
performOnForeground | TRUE = block during process (default is false) |
RETURN_CODE IDTechSDK.IDT_BTPay.device_sendConfiguration | ( | string | filename, |
VC_OPERATION_TYPE | type, | ||
bool | matchFW, | ||
string | ident = "" , |
||
bool | isForeground = false |
||
) |
Send Configuration Executes a ViVOconfig update or verify to a device
Once a ViVOconfig write or verify starts, all messages will be returned to the callback as DeviceState.ViVOconfig. The ViVOconfig operation is complete when the return code from a DeviceState.ViVOconfig message is one of the following values:
RETURN_CODE_SDK_VIVOCONFIG_WRITE_FAILED = Write process FAILED
filename | The .json configuration file to update the device with NOTE: You can also use this parameter to pass the path of where the .json file is located at on local storage instead |
filename | The name of the .json configuration file |
type | VC_OPERATION_TYPE |
matchFW | TRUE = Device FW must match file FW, FALSE = Don't validate device FW against file |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
isForeground | If TRUE, will block program until update complete. Otherwise, FALSE performs update on background. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_sendConfigurationFromZip | ( | byte[] | zip, |
string | filename, | ||
VC_OPERATION_TYPE | type, | ||
bool | matchFW, | ||
string | ident = "" , |
||
bool | isForeground = false |
||
) |
Send Configuration From Zip Executes a ViVOconfig update or verify to a device using files from a .zip archive
Once a ViVOconfig write or update starts, all messages will be returned to the callback as DeviceState.ViVOconfig. The ViVOconfig operation is complete when the return code from a DeviceState.ViVOconfig message is one of the following values:
RETURN_CODE_SDK_VIVOCONFIG_WRITE_FAILED = Write process FAILED
zip | .Zip archive containing the .json configuration file and also any associated image assets NOTE: You can also use this parameter to pass the path of where the .zip file is located at on local storage instead |
filename | The name of the .json configuration file |
type | VC_OPERATION_TYPE |
matchFW | TRUE = Device FW must match file FW, FALSE = Don't validate device FW against file |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
isForeground | If TRUE, will block program until update complete. Otherwise, FALSE performs update on background. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_sendDataCommand | ( | string | cmd, |
bool | calcLRC, | ||
ref byte[] | response, | ||
string | ident = "" |
||
) |
Send a NSData object to device
Sends a command represented by the provide NSData object to the device through the accessory protocol.
cmd | NSData representation of command to execute |
calcLRC | If TRUE , this will wrap command with start/length/lrc/sum/end: '{STX}{Len_Low}{Len_High} data {CheckLRC} {CheckSUM} {ETX}' |
response | Response data |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_sendPAE | ( | string | command, |
ref string | response, | ||
int | timeoutstring, | ||
string | ident = "" |
||
) |
Send Payment Application Engine Command
Executes a PAE command
command | ASCII command string, should start with "*PAE" |
response | command response |
timeout | timeout waiting for PAE response |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_setDateTime | ( | string | ident = "" | ) |
Set Date Time
Set current system date and time to the device.
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.device_startRKI | ( | string | ident = "" | ) |
Start Remote Key Injection
Starts a remote key injection request with IDTech RKI servers.
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_addTerminalData | ( | byte[] | tlv, |
string | ident = "" |
||
) |
Add Terminal Data
Adds to the exosting Terminal Data
tlv | TerminalData TLV Data |
ident | Optional identifier |
RETURN_CODE | Return codes listed as typedef enum in IDTCommon:RETURN_CODE. Values can be parsed with IDT_BTPay::device_getResponseCodeString:() |
|
static |
Allow fallback for EMV transactions. Default is TRUE
allow | TRUE = allow fallback, FALSE = don't allow fallback |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_authenticateTransaction | ( | byte[] | updatedTLV, |
string | ident = "" |
||
) |
Authenticate EMV Transaction Request
Authenticates the EMV transaction for an ICC card. Execute this after receiving response with result code 0x10 to emv_startTransaction
The tags will be returned in the callback routine.
@param updatedTLV TLV stream that can be used to update the following values: - 9F02: Amount - 9F03: Other amount - 9C: Transaction type - 5F57: Account type In addition tag DFEE1A can be sent to specify tag list to include in results. Example four tags 9F02, 9F36, 95, 9F37 to be included in response = DFEE1A079F029F369f9F37 @param ident Device ID to send command to. If not specified, current SDK default device will be used.
|
static |
Enables authenticate for EMV transactions. If a startEMVTranaction results in code 0x0010 (start transaction success), then emv_authenticateEMVTransaction can automatically execute if parameter is set to TRUE
authenticate | TRUE = auto authenticate, FALSE = manually authenticate |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
|
static |
Enables authenticate for EMV transactions. If a startEMVTranaction results in code 0x0010 (start transaction success), then emv_authenticateEMVTransaction can automatically execute if parameter is set to TRUE
authenticate | TRUE = auto authenticate, FALSE = manually authenticate |
tags | Tags to pass during authentication stage; |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_callbackResponseLCD | ( | EMV_LCD_DISPLAY_MODE | type, |
byte | selection, | ||
string | ident = "" |
||
) |
Callback Response LCD Display
Provides menu selection responses to the kernel after a callback was received with DeviceState.EMVCallback, and callbackType = EMV_CALLBACK_TYPE.EMV_CALLBACK_TYPE_LCD, and lcd_displayMode = EMV_LCD_DISPLAY_MODE_MENU, EMV_LCD_DISPLAY_MODE_PROMPT, or EMV_LCD_DISPLAY_MODE_LANGUAGE_SELECT
type | If Cancel key pressed during menu selection, then value is EMV_LCD_DISPLAY_MODE_CANCEL. Otherwise, value can be EMV_LCD_DISPLAY_MODE_MENU, EMV_LCD_DISPLAY_MODE_PROMPT, or EMV_LCD_DISPLAY_MODE_LANGUAGE_SELECT |
selection | If type = EMV_LCD_DISPLAY_MODE_MENU or EMV_LCD_DISPLAY_MODE_LANGUAGE_SELECT, provide the selection ID line number. Otherwise, if type = EMV_LCD_DISPLAY_MODE_PROMPT supply either 0x43 ('C') for Cancel, or 0x45 ('E') for Enter/accept |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_callbackResponseMSR | ( | byte[] | MSR, |
string | ident = "" |
||
) |
Callback Response MSR Entry
Provides MSR information to kernel after a callback was received with DeviceState.EMVCallback, and callbackType = EMV_CALLBACK_MSR
MSR | Swiped track data |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_callbackResponsePIN | ( | EMV_PIN_MODE | type, |
byte[] | KSN, | ||
byte[] | PIN, | ||
string | ident = "" |
||
) |
Callback Response PIN Entry
Provides (or cancels) PIN entry information to kernel after a callback was received with DeviceState.EMVCallback, and callbackType = EMV_CALLBACK_TYPE_PINPAD
type | If Cancel key pressed during PIN entry, then value is EMV_PIN_MODE_CANCEL. Otherwise, value can be EMV_PIN_MODE_ONLINE_DUKPT, EMV_PIN_MODE_ONLINE_MKSK, or EMV_PIN_MODE_OFFLINE |
KSN | If enciphered PIN, this is either the PIN DUKPT Key (EMV_PIN_MODE_ONLINE_DUKPT) or PIN Session Key (EMV_PIN_MODE_ONLINE_MKSK), or PIN Pairing DUKPT key (EMV_PIN_MODE_OFFLINE) |
PIN | If encipherd PIN, this is encrypted PIN block. If device does not implement pairing function, this is plaintext PIN |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_cancelTransaction | ( | string | ident = "" | ) |
Cancel EMV Transaction
Cancels the currently executing EMV transaction.
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_completeTransaction | ( | bool | commError, |
byte[] | authCode, | ||
byte[] | iad, | ||
byte[] | tlvScripts, | ||
byte[] | tlv, | ||
string | ident = "" |
||
) |
Complete EMV Transaction Request
Completes the EMV transaction for an ICC card when online authorization request is received from emv_authenticateTransaction
The tags will be returned in the callback routine.
commError | Communication error with host. Set to TRUE if host was unreachable, or FALSE if host response received. If Communication error, authCode, iad, tlvScripts can be null. |
authCode | Authorization code from host. Two bytes. Example 0x3030. (Tag value 8A). Required |
iad | Issuer Authentication Data, if any. Example 0x11223344556677883030 (tag value 91). |
tlvScripts | 71/72 scripts, if any |
tlv | Additional TVL data to return with transaction results (if any) |
NOTE: sending tag DFEF51 with a value of 01 (DFEF510101) as and Additional TLV data will Supress the results. Used for QuickChip implementation.
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
NOTE: There are three possible outcomes for Authorization Code: Approval, Refer To Bank, Decline. The kernel maps these three outcomes to valid authorization response codes using tag DFEE1B through 8 bytes: {2 bytes Approval Code}{2 bytes Referral Code}{2 bytes Decline Code}{2 bytes RFU} If your gateway uses "00" for Approval, "01" for Referral, and "05" for Decline, then DFEE1B 08 3030 3031 3035 0000 If you use an authorization code value that that is not defined in DFEE1B, the kernel will use the DECLINE value of DFEE1B by default.
RETURN_CODE IDTechSDK.IDT_BTPay.emv_getEMVConfigurationCheckValue | ( | ref string | response, |
string | ident = "" |
||
) |
Get EMV Kernel configuration check value info
response | Response returned of Kernel configuration check value info |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_getEMVKernelCheckValue | ( | ref string | response, |
string | ident = "" |
||
) |
Get EMV Kernel check value info
response | Response returned of Kernel check value info |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_getEMVKernelVersion | ( | ref string | response, |
string | ident = "" |
||
) |
Polls device for EMV Kernel Version
response | Response returned of Kernel Version |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_removeAllApplicationData | ( | string | ident = "" | ) |
Remove All Application Data
Removes all the Application Data
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_removeAllCAPK | ( | string | ident = "" | ) |
Remove All Certificate Authority Public Key
Removes all the CAPK
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_removeAllCRL | ( | string | ident = "" | ) |
Remove All Certificate Revocation List Entries
Removes all CRLEntry entries
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_removeApplicationData | ( | byte[] | AID, |
string | ident = "" |
||
) |
Remove Application Data by AID
Removes the Application Data as specified by the AID name passed as a parameter
AID | Name of ApplicationID Must be between 5 and 16 bytes |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_removeCAPK | ( | byte[] | capk, |
string | ident = "" |
||
) |
Remove Certificate Authority Public Key
Removes the CAPK as specified by the RID/Index
capk | 6 byte CAPK = 5 bytes RID + 1 byte INDEX |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_removeCRL | ( | byte[] | crlList, |
string | ident = "" |
||
) |
Remove Certificate Revocation List Entries
Removes CRLEntries as specified by the RID and Index and serial number passed as 9 bytes
crlList | containing the list of CRL to remove: [CRL1][CRL2]...[CRLn] where each [CRL] is 9 bytes: [5 bytes RID][1 byte CAPK Index][3 bytes serial number] |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_removeTerminalData | ( | string | ident = "" | ) |
Remove Terminal Data
Removes the Terminal Data
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_retrieveAIDList | ( | ref byte | response[][], |
string | ident = "" |
||
) |
Retrieve AID list
Returns all the AID names installed on the terminal.
response | array of AID name byte arrays |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_retrieveApplicationData | ( | byte[] | AID, |
ref byte[] | tlv, | ||
string | ident = "" |
||
) |
Retrieve Application Data by AID
Retrieves the Application Data as specified by the AID name passed as a parameter.
AID | Name of ApplicationID. Must be between 5 and 16 bytes |
tlv | The TLV elements of the requested AID |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_retrieveCAPK | ( | byte[] | capk, |
ref byte[] | key, | ||
string | ident = "" |
||
) |
Retrieve Certificate Authority Public Key
Retrieves the CAPK as specified by the RID/Index passed as a parameter.
capk | 6 bytes CAPK = 5 bytes RID + 1 byte Index |
key | Response returned as a CAKey format: [5 bytes RID][1 byte Index][1 byte Hash Algorithm][1 byte Encryption Algorithm][20 bytes HashValue][4 bytes Public Key Exponent][2 bytes Modulus Length][Variable bytes Modulus] Where:
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_retrieveCAPKList | ( | ref byte[] | keys, |
string | ident = "" |
||
) |
Retrieve the Certificate Authority Public Key list
Returns all the CAPK RID and Index installed on the terminal.
keys | [key1][key2]...[keyn], each key 6 bytes where key = 5 bytes RID + 1 byte index |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_retrieveCRLList | ( | ref byte[] | list, |
string | ident = "" |
||
) |
Retrieve the Certificate Revocation List
Returns the CRL entries on the terminal.
list | [CRL1][CRL2]...[CRLn], each CRL 9 bytes where CRL = 5 bytes RID + 1 byte index + 3 bytes serial number |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_retrieveTerminalData | ( | ref byte[] | tlv, |
string | ident = "" |
||
) |
Retrieve Terminal Data
Retrieves the Terminal Data.
tlv | Response returned as a TLV |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_retrieveTransactionResult | ( | byte[] | tags, |
ref IDTTransactionData | tlv, | ||
string | ident = "" |
||
) |
Retrieve Transaction Results
Retrieves specified EMV tags from the currently executing transaction.
tags | Tags to be retrieved. Example 0x9F028A will retrieve tags 9F02 and 8A |
tlv | All requested tags returned as unencrypted, encrypted and masked TLV data in IDDTransactionData object |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_setApplicationData | ( | byte[] | name, |
byte[] | tlv, | ||
string | ident = "" |
||
) |
Set Application Data by AID
Sets the Application Data as specified by the application name and TLV data
name | Application name, 10-32 ASCII hex characters representing 5-16 bytes Example "a0000000031010" |
tlv | Application data in TLV format |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_setCAPK | ( | byte[] | key, |
string | ident = "" |
||
) |
Set Certificate Authority Public Key
Sets the CAPK as specified by the CAKey structure
key | CAKey format: [5 bytes RID][1 byte Index][1 byte Hash Algorithm][1 byte Encryption Algorithm][20 bytes HashValue][4 bytes Public Key Exponent][2 bytes Modulus Length][Variable bytes Modulus] Where:
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_setCRL | ( | byte[] | list, |
string | ident = "" |
||
) |
Set Certificate Revocation List
Sets the CRL
list | CRL Entries containing the RID, Index, and serial numbers to set [CRL1][CRL2]...[CRLn] where each [CRL] is 9 bytes: [5 bytes RID][1 byte CAPK Index][3 bytes serial number] |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_setTerminalData | ( | byte[] | tlv, |
string | ident = "" |
||
) |
Set Terminal Data
Sets the Terminal Data
tlv | TerminalData TLV Data |
ident | Optional identifier |
RETURN_CODE | Return codes listed as typedef enum in IDTCommon:RETURN_CODE. Values can be parsed with IDT_BTPay::device_getResponseCodeString:() |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_setTerminalMajorConfiguration | ( | int | configuration, |
string | ident = "" |
||
) |
Set Terminal Major Configuration
Sets the Terminal Data Major Configuration setting
configuration | The configuration to set (1-5) |
RETURN_CODE | Return codes listed as typedef enum in IDTCommon:RETURN_CODE. Values can be parsed with IDT_BTPay::device_getResponseCodeString:() |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_startTransaction | ( | double | amount, |
double | amtOther, | ||
int | exponent, | ||
int | type, | ||
int | timeout, | ||
byte[] | tags, | ||
bool | forceOnline, | ||
bool | isFastEMV = false , |
||
string | ident = "" |
||
) |
Start EMV Transaction Request
Authorizes the EMV transaction for an ICC card
The tags will be returned in the callback routine.
amount | Transaction amount value (tag value 9F02) |
amtOther | Other amount value, if any (tag value 9F03) |
exponent | Number of characters after decimile point |
type | Transaction type (tag value 9C). |
timeout | Timeout value in seconds. |
tags | Any other tags to be included in the request. Passed as TLV Data. Example, tag 9F02 with amount 0x000000000100 would be 0x9F0206000000000100 If tags 9F02 (amount),9F03 (other amount), or 9C (transaction type) are included, they will take priority over these values supplied as individual parameters to this method. |
forceOnline | TRUE = do not allow offline approval, FALSE = allow ICC to approve offline if terminal capable Note: To request tags to be included in default response, use tag DFEE1A, and specify tag list. Example four tags 9F02, 9F36, 95, 9F37 to be included in response = DFEE1A079F029F369f9F37 |
isFastEMV | If TRUE, it will populate the IDTTransactionData.fastEMV with ASCII data similar to IDTech FastEMV KB output, after performing an auto-authenticate and auto-complete with ResultCode = Could Not Contact Host |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.emv_trySetTerminalData | ( | byte[] | tlv, |
ref byte[] | rejectedTLV, | ||
ref byte[] | convertedTLV, | ||
bool | overwrite = false , |
||
string | ident = "" |
||
) |
Try to Set Terminal Data
Atempts to set the Terminal Data. Use this functions to attempt to set the terminal data to the device. This function will allow the cross-device tag compatible writing of IDTech Legacy/New tag definitions
tlv | TerminalData TLV Data |
rejectedTLV | Contains the tags (if any) that were rejected by the firmware |
convertedTLV | Contains the tags (if any) that were converted and accepted by the firmware |
overwrite | TRUE = add TLV to existing tags, FALSE = replace existing tags with TLV |
ident | Optional identifier |
RETURN_CODE | Return codes listed as typedef enum in IDTCommon:RETURN_CODE. Values can be parsed with IDT_BTPay::device_getResponseCodeString:() |
|
static |
Get Command Timeout
Gets the default timeout (in milliseconds) waiting for a blocking command response
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
time | Time |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_disable | ( | string | ident = "" | ) |
ICC Function enable/disable Disable ICC function
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_enable | ( | bool | withNotification, |
string | ident = "" |
||
) |
ICC Function enable/disable Enable ICC function with or without seated notification
withNotification |
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_exchangeAPDU | ( | string | c_APDU, |
ref byte[] | response, | ||
string | ident = "" |
||
) |
Exchange APDU with plain text For Non-SRED Augusta Only
Sends an APDU packet to the ICC. If successful, response is the APDU data in response parameter.
c_APDU | APDU data packet |
response | Unencrypted APDU response |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_exchangeEncryptedAPDU | ( | string | c_APDU, |
ref byte[] | response, | ||
string | ident = "" |
||
) |
Exchange APDU with encrypted data For SRED Augusta Only
Sends an APDU packet to the ICC. If successful, response is the APDU data in response parameter.
c_APDU | KSN + encytpted APDU data packet, or no KSN (use last known KSN) + encrypted APDU data packet With KSN: [0A][KSN][Encrypted C-APDU] Without KSN: [00][Encrypted C-APDU] |
The format of Raw C-APDU Data Structure of [m-bytes Encrypted C-APDU] is below:
response | encrypted APDU response. Can be three options:
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_getAPDU_KSN | ( | ref byte[] | ksn, |
string | ident = "" |
||
) |
Get APDU KSN
Retrieves the KSN used in ICC Encypted APDU usage @param ksn Returns the encrypted APDU packet KSN
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_getFunctionStatus | ( | ref bool | enabled, |
ref bool | withNotification, | ||
string | ident = "" |
||
) |
Get ICC Function status Get ICC Function status about enable/disable and with or without seated notification
enabled |
|
withNotification | true means with notification when ICC seated status changed. false means without notification. |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_getICCReaderStatus | ( | ref byte | status, |
string | ident = "" |
||
) |
Get Reader Status
Returns the reader status
status | Pointer that will return with the ICCReaderStatus results. bit 0: 0 = ICC Power Not Ready, 1 = ICC Powered bit 1: 0 = Card not seated, 1 = card seated |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_getKeyFormatForICCDUKPT | ( | ref byte | format, |
string | ident = "" |
||
) |
Get Key Format For ICC DUKPT
Specifies how data will be encrypted with Data Key or PIN key (if DUKPT key loaded)
format | Response returned from method:
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_getKeyTypeForICCDUKPT | ( | ref byte | type, |
string | ident = "" |
||
) |
Get Key Type for ICC DUKPT
Specifies the key type used for ICC DUKPT encryption
type | Response returned from method:
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_powerOffICC | ( | string | ident = "" | ) |
Power Off ICC
Powers down the ICC
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
If Success, empty If Failure, ASCII encoded data of error string
RETURN_CODE IDTechSDK.IDT_BTPay.icc_powerOnICC | ( | ref byte[] | ATR, |
string | ident = "" |
||
) |
Power On ICC
Power up the currently selected microprocessor card in the ICC reader
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_setKeyFormatForICCDUKPT | ( | byte | encryption, |
string | ident = "" |
||
) |
Set Key Format for ICC DUKPT
Sets how data will be encrypted, with either TDES or AES (if DUKPT key loaded)
encryption | Encryption Type
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.icc_setKeyTypeForICCDUKPT | ( | byte | encryption, |
string | ident = "" |
||
) |
Set Key Type for ICC DUKPT Key
Sets which key the data will be encrypted with, with either Data Key or PIN key (if DUKPT key loaded)
encryption | Encryption Type
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_cancelMSRSwipe | ( | string | ident = "" | ) |
Disable MSR Swipe Cancels MSR swipe request.
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_captureMode | ( | bool | isBufferMode, |
bool | withNotification = false , |
||
string | ident = "" |
||
) |
Set MSR Capture Mode.
For Non-SRED Augusta Only
Switch between Auto mode and Buffer mode. Auto mode only available on KB interface
isBufferMode |
|
withNotification |
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_disable | ( | string | ident = "" | ) |
Disable MSR function.
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_getClearPANID | ( | ref byte | value, |
string | ident = "" |
||
) |
Get Clear PAN Digits
Returns the number of digits that begin the PAN that will be in the clear
value | Number of digits in clear. Values are char '0' - '6': |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_getExpirationMask | ( | ref byte | value, |
string | ident = "" |
||
) |
Get Expiration Masking
Get the flag that determines if to mask the expiration date
value | '0' = masked, '1' = not-masked |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_getFunctionStatus | ( | ref bool | enabled, |
ref bool | isBufferMode, | ||
ref bool | withNotification, | ||
string | ident = "" |
||
) |
Get MSR Function status Get MSR Function status about enable/disable and with or without seated notification
enabled |
|
isBufferMode |
|
withNotification |
|
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_getSetting | ( | byte | setting, |
ref byte | value, | ||
string | ident = "" |
||
) |
Get Single MSR Setting value
Returns the encryption used for sweip data
setting | MSR Setting to retrieve |
value | MSR Setting value |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_getSettings | ( | byte | setting, |
ref byte[] | value, | ||
string | ident = "" |
||
) |
Get Multi MSR Setting value
Returns the encryption used for sweip data
setting | MSR Setting to retrieve |
value | MSR Setting value |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_getSwipeEncryption | ( | ref byte | encryption, |
string | ident = "" |
||
) |
Get Swipe Data Encryption
For Non-SRED Augusta Only
Returns the encryption used for swipe data
encryption | 1 = TDES, 2 = AES, 0 = NONE |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_getSwipeForcedEncryptionOption | ( | ref byte | option, |
string | ident = "" |
||
) |
Get Swipe Data Encryption
Gets the swipe force encryption options
option | Byte using lower four bits as flags. 0 = Force Encryption Off, 1 = Force Encryption On bit0 = Track 1 bit1 = Track 2 bit2 = Track 3 bit4 = Track 3 Card Option 0 |
Example: Response 0x03 = Track1/Track2 Forced Encryption, Track3/Track3-0 no Forced Encryption
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_getSwipeMaskOption | ( | ref byte | option, |
string | ident = "" |
||
) |
Get Swipe Mask Option
Gets the swipe mask/clear data sending option
option | Byte using lower three bits as flags. 0 = Mask Option Off, 1 = Mask Option On bit0 = Track 1 bit1 = Track 2 bit2 = Track 3 |
Example: Response 0x03 = Track1/Track2 Masked Option ON, Track3 Masked Option Off
@param ident Device ID to send command to. If not specified, current SDK default device will be used.
RETURN_CODE IDTechSDK.IDT_BTPay.msr_RetrieveWhiteList | ( | ref byte[] | value, |
string | ident = "" |
||
) |
Retrieve MSR White List
For Non-SRED Augusta Only
value | is the white list data which is ASN.1 Block format |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_setClearPANID | ( | byte | val, |
string | ident = "" |
||
) |
Set Clear PAN Digits
Sets the amount of digits shown in the clear (not masked) at the beginning of the returned PAN value
val | Number of digits to show in clear. Range 0-6. |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_setExpirationMask | ( | bool | mask, |
string | ident = "" |
||
) |
Set Expiration Masking
Sets the flag to mask the expiration date
mask | TRUE = mask expiration |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_setSetting | ( | byte | setting, |
byte | value, | ||
string | ident = "" |
||
) |
Set Single MSR Setting value
@param setting MSR Setting to set @param value MSR Setting value
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_setSettings | ( | byte | setting, |
byte[] | value, | ||
string | ident = "" |
||
) |
Set Multi MSR Setting value
setting | MSR Setting to set |
value | MSR Setting value |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_setSwipeEncryption | ( | byte | encryption, |
string | ident = "" |
||
) |
Set Swipe Data Encryption
For Non-SRED Augusta Only
Sets the swipe encryption method
encryption | 1 = TDES, 2 = AES |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_setSwipeForcedEncryptionOption | ( | bool | track1, |
bool | track2, | ||
bool | track3, | ||
bool | track3card0, | ||
string | ident = "" |
||
) |
Set Swipe Force Encryption
Sets the swipe force encryption options
track1 | Force encrypt track 1 |
track2 | Force encrypt track 2 |
track3 | Force encrypt track 3 |
track3card0 | Force encrypt track 3 when card type is 0 |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_setSwipeMaskOption | ( | bool | track1, |
bool | track2, | ||
bool | track3, | ||
string | ident = "" |
||
) |
Set Swipe Mask Option
Sets the swipe mask/clear data sending option
track1 | Mask track 1 allowed |
track2 | Mask track 2 allowed |
track3 | Mask track 3 allowed |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_setWhiteList | ( | byte[] | value, |
byte[] | MAC, | ||
string | ident = "" |
||
) |
Set MSR White List
For Non-SRED Augusta Only
value | the white list data which is ASN.1 Block format |
MAC | Message Authenticate Code. For non-PCI, use null |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_startMSRSwipe | ( | int | timeout, |
string | ident = "" |
||
) |
Enable MSR Swipe
Enables MSR, waiting for swipe to occur. Allows track selection. Returns IDTMSRData instance to deviceDelegate::swipeMSRData:()
timeout | Swipe Timeout Value |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
RETURN_CODE IDTechSDK.IDT_BTPay.msr_switchUSBInterfaceMode | ( | bool | bIsUSBKeyboardMode | ) |
Switch the USB interface mode between USB HID and USB KB mode.
For Non-SRED Augusta Only
bIsUSBKeyboardMode | USB interface mode
|
RETURN_CODE IDTechSDK.IDT_BTPay.msr_switchUSBInterfaceMode | ( | bool | bIsUSBKeyboardMode, |
ref string | ident | ||
) |
Switch the USB interface mode between USB HID and USB KB mode.
For Non-SRED Augusta Only
bIsUSBKeyboardMode | USB interface mode
|
ident | Device ID to send command to. |
|
static |
SDK Version
Returns the current version of SDK
|
static |
Set Callback
Sets the class callback
my_Callback | The callback function to receive the response message from device. defined as follows. delegate void CallBack(IDT_DEVICE_Types sender, DeviceState state, byte[] data, IDTTransactionData card, EMV_Callback emvCallback, RETURN_CODE transactionResultCode); |
|
static |
Set Callback
Sets the class callback
my_Callback | The callback function to receive the response message from device. defined as follows. public unsafe delegate void MFCCallBack(Parameters parameters); |
context | The context of the UI thread |
|
static |
Set Command Timeout
Sets the default timeout (in milliseconds) waiting for a blocking command response
milliseconds | Time |
ident | Device ID to send command to. If not specified, current SDK default device will be used. |
|
static |
Use Serial Port Interface
Instructs SDK to attempt to use the Serial Port for communication with BTPay using default baud rate
port | Serial Port to use. Example COM1 = 1. |
|
static |
Use Serial Port Interface with baud rate
Instructs SDK to attempt to use the Serial Port for communication with BTPay
port | Serial Port to use. Example COM1 = 1. |
baud | Baud rate to override default. Example 115200; |
|
static |
Use Serial Port Interface on Linux
Instructs SDK to attempt to use the Serial Port for communication with BTMag using default baud rate on Linux implementations
path | Path to use. Example /dev/ttyUSB* |
|
static |
Use Serial Port Interface on Linux with baud rate
Instructs SDK to attempt to use the Serial Port for communication with BTPay on Linux implementations
path | Path to use. Example /dev/ttyUSB* |
baud | Baud rate to override default. Example 115200; |
|
staticget |