110
Class Documentation
Returns
RETURN_CODE:
• 0x0000: Success: no error - RETURN_CODE_DO_SUCCESS
• 0x0001: Disconnect: no response from reader - RETURN_CODE_ERR_DISCONNECT
• 0x0002: Invalid Response: invalid response data - RETURN_CODE_ERR_CMD_RESPONSE
• 0x0003: Timeout: time out for task or CMD - RETURN_CODE_ERR_TIMEDOUT
• 0x0004: Invalid Parameter: wrong parameter - RETURN_CODE_ERR_INVALID_PARAMETER
• 0x0005: MSR Busy: SDK is doing MSR or ICC task - RETURN_CODE_SDK_BUSY_MSR
• 0x0006: PINPad Busy: SDK is doing PINPad task - RETURN_CODE_SDK_BUSY_PINPAD
• 0x0007: Unknown: Unknown error - RETURN_CODE_ERR_OTHER
• 0x0100 through 0xFFFF refer to IDT_UniPayII::device_getResponseCodeString:()
13.7.2.61
- (RETURN_CODE) emv_setTerminalData: (NSDictionary
∗
)
data
Set Terminal Data
Sets the terminal configuration information, with TLV data that populates a NSDictionary.
The TLV data for the terminal configuration is sent as a NSDictionary, with the Key being the tag name as a NS
←
-
String representation of the tag hex value (example "DF13"), and the Object being the Value as NSData (example
0x00080039FF).
The data for the terminal configuration will will be from the range of allowable kernel EMV tags. Please see "EMV
Tag Reference" at the end of this document for the listing.
NOTES: There is an uneditable set of tags that make up the current kernel configuration major parameters. Any
attempt to set those will return an error.
If an AID is selected and matched during an EMV transaction, any data in that AID will either OVERRIDE the same
data in the terminal configuration file, or PROVIDE the data if it is non-existant in the terminal configuration file.
There are convenience utilities to turn a TLV NSData object into a NSDictionary, and a NSDictionary into a NSData
object in IDTUtility:
+(NSDictionary*) TLVtoDICT:(NSData*)param;
+(NSData*) DICTotTLV:(NSDictionary*)tags;
Also utilities to turn a HEX/ASCII string to NSDATA and back again
+ (NSData *)hexToData:(NSString*)str ;
+(NSString*) dataToHexString:(NSData*)data;
Parameters
data
NSDictionary with Tags/Values for the Terminal configuration file
Returns
RETURN_CODE:
• 0x0000: Success: no error - RETURN_CODE_DO_SUCCESS
• 0x0001: Disconnect: no response from reader - RETURN_CODE_ERR_DISCONNECT
• 0x0002: Invalid Response: invalid response data - RETURN_CODE_ERR_CMD_RESPONSE
• 0x0003: Timeout: time out for task or CMD - RETURN_CODE_ERR_TIMEDOUT
• 0x0004: Invalid Parameter: wrong parameter - RETURN_CODE_ERR_INVALID_PARAMETER
#80152504-001 IDTech iOS SDK Guide for NEO2
