IDTech iOS/OSX SDK Guide  1.1.082
API reference for UniPay 1.5
<IDTechEMV_Delegate> Protocol Reference

#import <IDTechEMV.h>

Inheritance diagram for <IDTechEMV_Delegate>:

Instance Methods

(void) - confirmApplicationSelection:retry:
 
(void) - languagePreference:
 
(void) - emvTransactionData:errorCode:performReversal:
 
(void) - emvTransactionMessage:
 
(void) - swipeMSRDataEMV:emv:
 Receives card data from MSR swipe.
 

Detailed Description

Protocol methods established for IDTechEMV class

Method Documentation

- (void) confirmApplicationSelection: (NSArray *)  labelArray
retry: (BOOL)  tryAgain 
optional

Receives available applications to select from during and EMV transactions when terminal is set for cardholder confirmation or a decision must be made between multiple applications available for selection. Array index of selected app must be passed back to confirmApplication: (IDTechEMV) to continue the EMV transaction flow.

Parameters
labelArrayArray of available application labels. Use this array item index to pass back to confirmApplication: (IDTechEMV)
tryAgainFlag to indicate requirement to display "Try Again" along with application selection.
- (void) emvTransactionData: (IDTEMVData *)  emvData
errorCode: (int)  error
performReversal: (BOOL)  reversal 
optional

EMV Transaction Data

This protocol will receive results from IDT_Device::startEMVTransaction:otherAmount:timeout:cashback:additionalTags:()

Parameters
emvDataEMV Results Data. Result code, card type, encryption type, masked tags, encrypted tags, unencrypted tags and KSN
errorThe error code as defined in the errors.h file
reversalIf this flag is TRUE, this means the transaction was APPROVED online, but a TC was not returned by the kernel and the transaction was declined. In most cases, the online host needs to be contacted to reverse the approval.
- (void) emvTransactionMessage: (MESSAGE_Types)  message
optional

EMV Messages

During an EMV Transaction flow , this delegate with pass messages that to request further interaction, or post information

Parameters
messageEMV Message Type-
typedef enum{
MESSAGE_INSERT_CARD = 0,
MESSAGE_REMOVE_CARD
}EMV_MESSAGE_Types;
- (void) languagePreference: (NSData *)  lang
optional

Language Preference

After the kernal loads the Application, it will send back the Language Preference, tag 5F2D. This can be used to determine what language to use when displaying prompts and messages for the remainder of the transaction flow.

Parameters
lang1-4 languages stored in order of preference, each represented by 2 alphabetical characters according to ISO 639.

The documentation for this protocol was generated from the following file: