| IDTech Universal SDK 1.0.35.027 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.