![]() |
IDTech Windows SDK Guide
1.0.35.0
API reference for Augusta
|
Public Member Functions | |
RETURN_CODE | emv_startTransaction (double amount, double amtOther, int exponent, int type, int timeout, byte[] tags, bool forceOnline) |
RETURN_CODE | emv_authenticateTransaction (byte[] updatedTLV) |
RETURN_CODE | emv_completeTransaction (bool commError, byte[] authCode, byte[] iad, byte[] tlvScripts, byte[] tlv) |
RETURN_CODE | emv_callbackResponseLCD (EMV_LCD_DISPLAY_MODE type, byte selection) |
RETURN_CODE | emv_callbackResponsePIN (EMV_PIN_MODE type, byte[] KSN, byte[] PIN) |
RETURN_CODE | emv_callbackResponseMSR (byte[] MSR) |
RETURN_CODE | emv_cancelTransaction () |
RETURN_CODE | emv_getEMVKernelVersion (ref string response) |
RETURN_CODE | emv_getEMVKernelCheckValue (ref string response) |
RETURN_CODE | emv_getEMVConfigurationCheckValue (ref string response) |
RETURN_CODE | emv_retrieveTransactionResult (byte[] tags, ref IDTTransactionData tlv) |
RETURN_CODE | emv_removeApplicationData (byte[] AID) |
RETURN_CODE | emv_removeAllApplicationData () |
RETURN_CODE | emv_removeCAPK (byte[] capk) |
RETURN_CODE | emv_removeAllCAPK () |
RETURN_CODE | emv_removeCRL (byte[] crlList) |
RETURN_CODE | emv_removeAllCRL () |
RETURN_CODE | emv_removeTerminalData () |
RETURN_CODE | emv_retrieveAIDList (ref byte[][] response) |
RETURN_CODE | emv_retrieveApplicationData (byte[] AID, ref byte[] tlv) |
RETURN_CODE | emv_retrieveCAPK (byte[] capk, ref byte[] key) |
RETURN_CODE | emv_retrieveCAPKList (ref byte[] keys) |
RETURN_CODE | emv_retrieveCRLList (ref byte[] list) |
RETURN_CODE | emv_retrieveTerminalData (ref byte[] tlv) |
RETURN_CODE | emv_setApplicationData (byte[] name, byte[] tlv) |
RETURN_CODE | emv_setCAPK (byte[] key) |
RETURN_CODE | emv_setCRL (byte[] list) |
RETURN_CODE | emv_setTerminalData (byte[] tlv) |
RETURN_CODE | config_getModelNumber (ref string response) |
RETURN_CODE | config_getSerialNumber (ref string response) |
bool | config_setCmdTimeOutDuration (int newTimeOut) |
RETURN_CODE | config_setLEDController (bool firmwareControlMSRLED, bool firmwareControlICCLED=false) |
RETURN_CODE | config_getLEDController (ref bool firmwareControlMSRLED, ref bool firmwareControlICCLED) |
RETURN_CODE | config_setBeeperController (bool firmwareControlBeeper) |
RETURN_CODE | config_getBeeperController (ref bool firmwareControlBeeper) |
RETURN_CODE | device_controlLED_ICC (int controlMode, int interval) |
RETURN_CODE | device_controlBeep (int index, int frequency, int duration) |
RETURN_CODE | device_controlLED (byte indexLED, byte control, int intervalOn=500, int intervalOff=500) |
RETURN_CODE | config_setEncryptionControl (bool msr, bool icc) |
RETURN_CODE | config_getEncryptionControl (ref bool msr, ref bool icc) |
RETURN_CODE | device_getKeyStatus (ref byte[] status) |
RETURN_CODE | device_setDateTime () |
RETURN_CODE | device_getFirmwareVersion (ref string response) |
string | device_getResponseCodeString (RETURN_CODE eCode) |
RETURN_CODE | device_rebootDevice () |
RETURN_CODE | device_sendDataCommand (string cmd, bool calcLRC, ref byte[] response) |
RETURN_CODE | device_controlLED_MSR (byte control, int intervalOn=500, int intervalOff=500) |
RETURN_CODE | icc_enable (bool withNotification) |
RETURN_CODE | icc_disable () |
RETURN_CODE | icc_getFunctionStatus (ref bool enabled, ref bool withNotification) |
RETURN_CODE | icc_exchangeAPDU (string c_APDU, ref byte[] response) |
RETURN_CODE | icc_exchangeEncryptedAPDU (string c_APDU, ref byte[] response) |
RETURN_CODE | icc_getAPDU_KSN (ref byte[] ksn) |
RETURN_CODE | icc_getICCReaderStatus (ref byte status) |
RETURN_CODE | icc_getKeyFormatForICCDUKPT (ref byte format) |
RETURN_CODE | icc_getKeyTypeForICCDUKPT (ref byte type) |
RETURN_CODE | icc_powerOffICC () |
RETURN_CODE | icc_powerOnICC (ref byte[] ATR) |
RETURN_CODE | icc_setKeyFormatForICCDUKPT (byte encryption) |
RETURN_CODE | icc_setKeyTypeForICCDUKPT (byte encryption) |
RETURN_CODE | msr_enableBufferMode (bool isBufferMode, bool withNotification=false) |
RETURN_CODE | msr_disable () |
RETURN_CODE | msr_getFunctionStatus (ref bool enabled, ref bool isBufferMode, ref bool withNotification) |
RETURN_CODE | msr_switchUSBInterfaceMode (bool bIsUSBKeyboardMode) |
RETURN_CODE | msr_getClearPANID (ref byte value) |
RETURN_CODE | msr_getExpirationMask (ref byte value) |
RETURN_CODE | msr_getSwipeEncryption (ref byte encryption) |
RETURN_CODE | msr_getSwipeForcedEncryptionOption (ref byte option) |
RETURN_CODE | msr_getSwipeMaskOption (ref byte option) |
RETURN_CODE | msr_RetrieveWhiteList (ref byte[] value) |
RETURN_CODE | msr_getSetting (byte setting, ref byte value) |
RETURN_CODE | msr_getSetting (byte setting, ref byte[] value) |
RETURN_CODE | msr_setSetting (byte setting, byte value) |
RETURN_CODE | msr_setSetting (byte setting, byte[] value) |
RETURN_CODE | msr_setClearPANID (byte val) |
RETURN_CODE | msr_setExpirationMask (bool mask) |
RETURN_CODE | msr_setSwipeEncryption (byte encryption) |
RETURN_CODE | msr_setSwipeForcedEncryptionOption (bool track1, bool track2, bool track3, bool track3card0) |
RETURN_CODE | msr_setSwipeMaskOption (bool track1, bool track2, bool track3) |
RETURN_CODE | msr_setWhiteList (byte[] value, byte[] MAC) |
RETURN_CODE | msr_startMSRSwipe (int timeout) |
RETURN_CODE | msr_cancelMSRSwipe () |
RETURN_CODE | device_setAugustaBDK (string BDK) |
bool | device_isSRED () |
Static Public Member Functions | |
static void | loadDLLs () |
static void | setCallback (CallBack my_Callback) |
static void | setCallback (IntPtr my_Callback, SynchronizationContext context) |
static void | emv_autoAuthenticate (bool authenticate) |
static void | emv_allowFallback (bool allow) |
static String | SDK_Version () |
Properties | |
static IDT_Augusta | SharedController [get] |
Class for Augusta/AugustaSRED MSR/ICC reader
RETURN_CODE IDTechSDK.IDT_Augusta.config_getBeeperController | ( | ref bool | firmwareControlBeeper | ) |
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. |
RETURN_CODE IDTechSDK.IDT_Augusta.config_getEncryptionControl | ( | ref bool | msr, |
ref bool | icc | ||
) |
Get Encryption Control
Get Encryption Control to switch status between MSR and ICC/EMV function. Following Encryption status supported:
msr |
|
icc |
|
RETURN_CODE IDTechSDK.IDT_Augusta.config_getLEDController | ( | ref bool | firmwareControlMSRLED, |
ref bool | firmwareControlICCLED | ||
) |
Get the LED Controller Status Get the MSR / ICC LED controlled status by software or firmware
firmwareControlMSRLED |
|
firmwareControlICCLED |
|
RETURN_CODE IDTechSDK.IDT_Augusta.config_getModelNumber | ( | ref string | response | ) |
Polls device for Model Number
response | Returns Model Number |
RETURN_CODE IDTechSDK.IDT_Augusta.config_getSerialNumber | ( | ref string | response | ) |
Polls device for Serial Number
response | Returns Serial Number |
RETURN_CODE IDTechSDK.IDT_Augusta.config_setBeeperController | ( | bool | firmwareControlBeeper | ) |
Set the Beeper Controller Set the Beeper controlled by software or firmware
firmwareControlBeeper | true means firmware control the beeper, false means software control beeper. |
bool IDTechSDK.IDT_Augusta.config_setCmdTimeOutDuration | ( | int | newTimeOut | ) |
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_Augusta.config_setEncryptionControl | ( | bool | msr, |
bool | icc | ||
) |
Set Encryption Control
Set Encryption Control to switch status between MSR and ICC/EMV function. Following Encryption status supported:
msr |
|
icc |
|
RETURN_CODE IDTechSDK.IDT_Augusta.config_setLEDController | ( | bool | firmwareControlMSRLED, |
bool | firmwareControlICCLED = false |
||
) |
Set the LED Controller Set the MSR / ICC LED controlled by software or firmware NOTE: The ICC LED always controlled by software.
firmwareControlMSRLED |
|
firmwareControlICCLED |
|
RETURN_CODE IDTechSDK.IDT_Augusta.device_controlBeep | ( | int | index, |
int | frequency, | ||
int | duration | ||
) |
Control Beep
Controls the Beeper
index | For Augusta, must be set to 1 (only one beeper) |
frequency | Frequency, range 1000-2000 (suggest minimum 3000) |
duration | Duration, in milliseconds (range 1 - 65536) |
RETURN_CODE IDTechSDK.IDT_Augusta.device_controlLED | ( | byte | indexLED, |
byte | control, | ||
int | intervalOn = 500 , |
||
int | intervalOff = 500 |
||
) |
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) |
RETURN_CODE IDTechSDK.IDT_Augusta.device_controlLED_ICC | ( | int | controlMode, |
int | interval | ||
) |
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) |
RETURN_CODE IDTechSDK.IDT_Augusta.device_controlLED_MSR | ( | byte | control, |
int | intervalOn = 500 , |
||
int | intervalOff = 500 |
||
) |
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) |
RETURN_CODE IDTechSDK.IDT_Augusta.device_getFirmwareVersion | ( | ref string | response | ) |
Polls device for Firmware Version
response | Response returned of Firmware Version |
RETURN_CODE IDTechSDK.IDT_Augusta.device_getKeyStatus | ( | ref byte[] | status | ) |
Get Key Status
Gets the status of loaded keys
status | 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 |
string IDTechSDK.IDT_Augusta.device_getResponseCodeString | ( | RETURN_CODE | eCode | ) |
Get the description of response result.
eCode | the response result. |
the | string for description of response result |
bool IDTechSDK.IDT_Augusta.device_isSRED | ( | ) |
Check if the device support SRED feature.
RETURN_CODE IDTechSDK.IDT_Augusta.device_rebootDevice | ( | ) |
Reboot Device
Executes a command to restart the device.
RETURN_CODE IDTechSDK.IDT_Augusta.device_sendDataCommand | ( | string | cmd, |
bool | calcLRC, | ||
ref byte[] | response | ||
) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.device_setAugustaBDK | ( | string | BDK | ) |
Set the BDK for MAC Algorithm (Only for the SRED device)
Set the BDK for MAC Algorithm when using the SRED device. It's one string of BDK looks like "0123456789ABCDEFFEDCBA9876543210", need string length is 32.
The following APIs need MAC Algorithm on the SRED device.
emv_setCRL emv_setCAPK device_setDateTime msr_setWhiteList
RETURN_CODE IDTechSDK.IDT_Augusta.device_setDateTime | ( | ) |
Set Date Time
Set current system date and time to the device.
|
static |
Allow fallback for EMV transactions. Default is TRUE
allow | TRUE = allow fallback, FALSE = don't allow fallback |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_authenticateTransaction | ( | byte[] | updatedTLV | ) |
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 @return RETURN_CODE: Values can be parsed with device_getResponseCodeString
|
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_callbackResponseLCD | ( | EMV_LCD_DISPLAY_MODE | type, |
byte | selection | ||
) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_callbackResponseMSR | ( | byte[] | MSR | ) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_callbackResponsePIN | ( | EMV_PIN_MODE | type, |
byte[] | KSN, | ||
byte[] | PIN | ||
) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_cancelTransaction | ( | ) |
Cancel EMV Transaction
Cancels the currently executing EMV transaction.
RETURN_CODE IDTechSDK.IDT_Augusta.emv_completeTransaction | ( | bool | commError, |
byte[] | authCode, | ||
byte[] | iad, | ||
byte[] | tlvScripts, | ||
byte[] | tlv | ||
) |
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) |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_getEMVConfigurationCheckValue | ( | ref string | response | ) |
Get EMV Kernel configuration check value info
response | Response returned of Kernel configuration check value info |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_getEMVKernelCheckValue | ( | ref string | response | ) |
Get EMV Kernel check value info
response | Response returned of Kernel check value info |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_getEMVKernelVersion | ( | ref string | response | ) |
Polls device for EMV Kernel Version
response | Response returned of Kernel Version |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_removeAllApplicationData | ( | ) |
Remove All Application Data
Removes all the Application Data
RETURN_CODE IDTechSDK.IDT_Augusta.emv_removeAllCAPK | ( | ) |
Remove All Certificate Authority Public Key
Removes all the CAPK
RETURN_CODE IDTechSDK.IDT_Augusta.emv_removeAllCRL | ( | ) |
Remove All Certificate Revocation List Entries
Removes all CRLEntry entries
RETURN_CODE IDTechSDK.IDT_Augusta.emv_removeApplicationData | ( | byte[] | AID | ) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_removeCAPK | ( | byte[] | capk | ) |
Remove Certificate Authority Public Key
Removes the CAPK as specified by the RID/Index
capk | 6 byte CAPK = 5 bytes RID + 1 byte INDEX |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_removeCRL | ( | byte[] | crlList | ) |
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] |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_removeTerminalData | ( | ) |
Remove Terminal Data
Removes the Terminal Data
RETURN_CODE IDTechSDK.IDT_Augusta.emv_retrieveAIDList | ( | ref byte | response[][] | ) |
Retrieve AID list
Returns all the AID names installed on the terminal.
response | array of AID name byte arrays |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_retrieveApplicationData | ( | byte[] | AID, |
ref byte[] | tlv | ||
) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_retrieveCAPK | ( | byte[] | capk, |
ref byte[] | key | ||
) |
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:
|
RETURN_CODE IDTechSDK.IDT_Augusta.emv_retrieveCAPKList | ( | ref byte[] | keys | ) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_retrieveCRLList | ( | ref byte[] | list | ) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_retrieveTerminalData | ( | ref byte[] | tlv | ) |
Retrieve Terminal Data
Retrieves the Terminal Data.
tlv | Response returned as a TLV |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_retrieveTransactionResult | ( | byte[] | tags, |
ref IDTTransactionData | tlv | ||
) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_setApplicationData | ( | byte[] | name, |
byte[] | tlv | ||
) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_setCAPK | ( | byte[] | key | ) |
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:
|
RETURN_CODE IDTechSDK.IDT_Augusta.emv_setCRL | ( | byte[] | list | ) |
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] |
RETURN_CODE IDTechSDK.IDT_Augusta.emv_setTerminalData | ( | byte[] | tlv | ) |
Set Terminal Data
Sets the Terminal Data as specified by the TerminalData structure passed as a parameter
tlv | TerminalData configuration file |
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_Augusta.emv_startTransaction | ( | double | amount, |
double | amtOther, | ||
int | exponent, | ||
int | type, | ||
int | timeout, | ||
byte[] | tags, | ||
bool | forceOnline | ||
) |
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 a string. Example, tag 9F0C with amount 0x000000000100 would be "9F0C06000000000100" 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 |
RETURN_CODE IDTechSDK.IDT_Augusta.icc_disable | ( | ) |
ICC Function enable/disable Disable ICC function
RETURN_CODE IDTechSDK.IDT_Augusta.icc_enable | ( | bool | withNotification | ) |
ICC Function enable/disable Enable ICC function with or without seated notification
withNotification |
|
RETURN_CODE IDTechSDK.IDT_Augusta.icc_exchangeAPDU | ( | string | c_APDU, |
ref byte[] | response | ||
) |
Exchange APDU with plain text
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.icc_exchangeEncryptedAPDU | ( | string | c_APDU, |
ref byte[] | response | ||
) |
Exchange APDU with encrypted data
Sends an APDU packet to the ICC. If successful, response is the APDU data in response parameter.
c_APDU | APDU data packet |
response | encrypted APDU response |
RETURN_CODE IDTechSDK.IDT_Augusta.icc_getAPDU_KSN | ( | ref byte[] | ksn | ) |
Get APDU KSN
Retrieves the KSN used in ICC Encypted APDU usage
ksn | Returns the encrypted APDU packet KSN |
RETURN_CODE IDTechSDK.IDT_Augusta.icc_getFunctionStatus | ( | ref bool | enabled, |
ref bool | withNotification | ||
) |
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. |
RETURN_CODE IDTechSDK.IDT_Augusta.icc_getICCReaderStatus | ( | ref byte | status | ) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.icc_getKeyFormatForICCDUKPT | ( | ref byte | format | ) |
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:
|
RETURN_CODE IDTechSDK.IDT_Augusta.icc_getKeyTypeForICCDUKPT | ( | ref byte | type | ) |
Get Key Type for ICC DUKPT
Specifies the key type used for ICC DUKPT encryption
type | Response returned from method:
|
RETURN_CODE IDTechSDK.IDT_Augusta.icc_powerOffICC | ( | ) |
Power Off ICC
Powers down the ICC
If Success, empty If Failure, ASCII encoded data of error string
RETURN_CODE IDTechSDK.IDT_Augusta.icc_powerOnICC | ( | ref byte[] | ATR | ) |
Power On ICC
Power up the currently selected microprocessor card in the ICC reader
RETURN_CODE IDTechSDK.IDT_Augusta.icc_setKeyFormatForICCDUKPT | ( | byte | encryption | ) |
Set Key Format for ICC DUKPT
Sets how data will be encrypted, with either TDES or AES (if DUKPT key loaded)
encryption | Encryption Type
|
RETURN_CODE IDTechSDK.IDT_Augusta.icc_setKeyTypeForICCDUKPT | ( | byte | encryption | ) |
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
|
|
static |
Load DLL's
Instructs SDK to load device DLLs. Should be executed on SDK initialization.
RETURN_CODE IDTechSDK.IDT_Augusta.msr_cancelMSRSwipe | ( | ) |
Disable MSR Swipe Cancels MSR swipe request.
RETURN_CODE IDTechSDK.IDT_Augusta.msr_disable | ( | ) |
Disable MSR function.
RETURN_CODE IDTechSDK.IDT_Augusta.msr_enableBufferMode | ( | bool | isBufferMode, |
bool | withNotification = false |
||
) |
Enable MSR Buffer/Auto Mode function.
Switch between Auto mode and Buffer mode. Only succeeded on USB KB interface.
isBufferMode |
|
withNotification |
|
RETURN_CODE IDTechSDK.IDT_Augusta.msr_getClearPANID | ( | ref byte | value | ) |
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': |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_getExpirationMask | ( | ref byte | value | ) |
Get Expiration Masking
Get the flag that determines if to mask the expiration date
value | '0' = masked, '1' = not-masked |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_getFunctionStatus | ( | ref bool | enabled, |
ref bool | isBufferMode, | ||
ref bool | withNotification | ||
) |
Get MSR Function status Get MSR Function status about enable/disable and with or without seated notification
enabled |
|
isBufferMode |
|
withNotification |
|
RETURN_CODE IDTechSDK.IDT_Augusta.msr_getSetting | ( | byte | setting, |
ref byte | value | ||
) |
Get Single MSR Setting value
Returns the encryption used for sweip data
setting | MSR Setting to retrieve |
value | MSR Setting value |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_getSetting | ( | byte | setting, |
ref byte[] | value | ||
) |
Get Multi MSR Setting value
Returns the encryption used for sweip data
setting | MSR Setting to retrieve |
value | MSR Setting value |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_getSwipeEncryption | ( | ref byte | encryption | ) |
Get Swipe Data Encryption
Returns the encryption used for sweip data
encryption | 1 = TDES, 2 = AES, 0 = NONE |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_getSwipeForcedEncryptionOption | ( | ref byte | option | ) |
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
RETURN_CODE IDTechSDK.IDT_Augusta.msr_getSwipeMaskOption | ( | ref byte | option | ) |
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
RETURN_CODE IDTechSDK.IDT_Augusta.msr_RetrieveWhiteList | ( | ref byte[] | value | ) |
Retrieve MSR White List
value | is the white list data which is ASN.1 Block format |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_setClearPANID | ( | byte | val | ) |
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. |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_setExpirationMask | ( | bool | mask | ) |
Set Expiration Masking
Sets the flag to mask the expiration date
mask | TRUE = mask expiration |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_setSetting | ( | byte | setting, |
byte | value | ||
) |
Set Single MSR Setting value
setting | MSR Setting to set |
value | MSR Setting value |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_setSetting | ( | byte | setting, |
byte[] | value | ||
) |
Set Multi MSR Setting value
setting | MSR Setting to set |
value | MSR Setting value |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_setSwipeEncryption | ( | byte | encryption | ) |
Set Swipe Data Encryption
Sets the swipe encryption method
encryption | 1 = TDES, 2 = AES |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_setSwipeForcedEncryptionOption | ( | bool | track1, |
bool | track2, | ||
bool | track3, | ||
bool | track3card0 | ||
) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_setSwipeMaskOption | ( | bool | track1, |
bool | track2, | ||
bool | track3 | ||
) |
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 |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_setWhiteList | ( | byte[] | value, |
byte[] | MAC | ||
) |
Set MSR White List
value | the white list data which is ASN.1 Block format |
MAC | Message Authenticate Code. For non-PCI, use null |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_startMSRSwipe | ( | int | timeout | ) |
Enable MSR Swipe
Enables MSR, waiting for swipe to occur. Allows track selection. Returns IDTMSRData instance to deviceDelegate::swipeMSRData:()
timeout | Swipe Timeout Value |
RETURN_CODE IDTechSDK.IDT_Augusta.msr_switchUSBInterfaceMode | ( | bool | bIsUSBKeyboardMode | ) |
Switch the USB interface mode between USB HID and USB KB mode.
bIsUSBKeyboardMode | USB interface mode
|
|
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 |
|
staticget |
Singleton Instance
Establishes an singleton instance of IDT_Augusta class.