IDTech Universal SDK  1.0.35.038
API reference for C++
Main Transaction Commands

The methods below are provided as a reference to the main commands needed to execute an EMV transaction.

EMV Methods

Start EMV Transaction
emv_startTransaction()

Begins an amount authorization request with the ICC. Returns authorization decision (approved, denied, or go online) in the callback method.


Authenticate EMV Transaction
emv_authenticateTransaction()

When the results to emv_startTransaction() come back as EMV_RESULT_CODE.EMV_RESULT_CODE_AUTHENTICATE_TRANSACTION, continuing the EMV transaction requires calling this method.


Complete Online EMV Transaction
emv_completeTransaction()

If start/authenticate transaction returns EMV_RESULT_CODE.EMV_RESULT_CODE_GO_ONLINE, finishing the transaction requires executing emv_completeTransaction().

After receiving a host response, pass host tags (minimum 8A Authorization Response Code) as a parameter.

If there was a communication error with host, finishing the EMV transaction still requires passing "TRUE" for commError.


Terminal Configuration
emv_retrieveTerminalData()
emv_removeTerminalData()
emv_setTerminalData()
Methods for terminal configuration. When setting terminal data, pass the tags in TLV format.
AID Management
emv_retrieveApplicationData()
emv_removeApplicationData()
emv_removeAllApplicationData()
emv_setApplicationData()
emv_retrieveAIDList()
Methods for AID management. When setting the AID, pass the tags in TLV format. When retrieving the AID, receive the results as tags in TLV format.
CAPK Management
emv_retrieveCAPK()
emv_removeCAPK()
emv_removeAllCAPK()
emv_setCAPK()
emv_retrieveCAPKList()

Methods for Certificate Authority Public Key management. When setting the CAPK, populate and pass the key as a sequence of ordered bytes. When specifying a CAPK to retrieve or remove, populate the name in the byte* pointer. When retrieving the CAPK list, retrieve the list of RID/Index from the ordered byte stream, 6 bytes each, bytes 1-5 RID, byte 6 index.


CRL Management
emv_removeCRL()
emv_removeAllCRL()
emv_retrieveCRL()
emv_setCRL()

Methods for Certificate Revocation List management.


Kernel Version
emv_getEMVKernelVersion()

Method to retrieve the kernel version.


Kernel Check Value
emv_getEMVKernelCheckValue()

Method to retrieve the kernel Check Value.


EMV Configuration Check Value
emv_getEMVConfigurationCheckValue()

Method to retrieve the EMV configuration check value.


MSR Methods

Start MSR Swipe
msr_startMSRSwipe()

Starts a swipe request. Returns card data in the callback method.


Cancel MSR Swipe
msr_cancelMSRSwipe()

Cancels a swipe request.