IDTECH NEO2 - Page 118

108 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_Device::getResponseCodeString:()
13.7.2.58 - (RETURN_CODE) emv_setApplicationData: (NSString ∗) aidName configData:(NSDictionary ∗) data
Set Application Data by AID
Sets the configuration information for a provided AID name, with TLV data that populates a NSDictionary.
The TLV data for the AID is sent as a NSDictionary, with the Key being the tag name as a NSString representation
of the tag hex value (example "9F06"), and the Object being the Value as NSData (example 0xa0000000031010).
The data for the AID 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 no minimum defined set of AID TLV data that must be provided, other than 9F06 for the AID name.
If this AID is selected and matched during an EMV transaction, any data in this 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.
AID configuration information is provided during L3 certification. Dummy/stub AID data can be used pre-certification
to test EMV transaction as long as at least tag 9F06 is defined that makes up the AID configuration locator.
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
aidName aidName AID name. Example "a0000000031010"
data NSDictionary with Tags/Values for the AID 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
#80152504-001 IDTech iOS SDK Guide for NEO2