![]() |
IDTech iOS/OSX SDK Guide
1.1.052
API reference for BTPay 200
|
The methods below are provided as a reference to the main commands needed to execute an EMV transaction, collect PADPad input, or perform a swipe. Some commands not applicable on some devices.
Begins an amount authorization request with the ICC. Returns authorization decision (approved, denied, or go online) in delegate method.
After receiving a host response, pass host tags (minimum 8A Authorization Response Code) as a dictionary through the tags parameter. EMV tags can be parsed returned pointer.
If there was a communication error with host, you must still finish the EMV transaction by passing "FALSE" for isSuccess, and nil for tags.
Methods for terminal configuration. When setting the terminal data, you populate and pass and TerminalFile structure. When retrieving terminal data, you can receive the results in the TerminalFile structure in IDTResult.TerminalData
Methods for AID management. When setting the AID, you populate and pass and AID structure. When retrieving AID, you can receive the results in the AID structure in IDTResult.aidResponse. When retrieving the AID list, the list of AID Names/length can be retrieved from the populated NSArray
Methods for Certificate Authority Public Key management. When setting the CAPK, you populate and pass and CAKey structure. When specifying a CAPK to retrieve or remove, you populate the relevant fields in the CAKey structure. When retrieving CAPK, you can receive the results in the CAKey structure in IDTResult.caKeyData. When retrieving the CAPK list, the list of RID/Index can be retrieved from IDTResult.arrayResult with an array of NSData items, 6 bytes each, bytes 1-5 RID, byte 6 index
Methods for Certificate Revocation List management. When setting the CRL, you populate and pass and CRLEntry structure. When retrieving CRL data, reference IDTResult.arrayResult for either an NSArray of NSData 5-byte objects for each RID,, or a NSArray of NSData objects for each serial number found. When specifying CRL, you use CRLEntry structure
Method to retrieve kernel version. Valued returned in IDTResult.data
Allows the direct sending of APDU packets to ICC
These methods prompt for input on the PINpad. Pinpad input results are returned to the delegate protocol:
lcd_displayMessage:line2:line3:line4: (IDT_BTPay)
Displays up to 4 lines of text
lcd_showJPEG:Y0:X1:Y1: (IDT_BTPay)
Displays a picture uploaded with device_uploadJPEG: (IDT_BTPay)
Sets and gets the encrypted MSR Data Output Format. Can be encrypted with Data Key or PIN key.
Enables MSR to receive Swipe. Results are returned as IDTMSRData in swipeMSRData
Disables the MSR from receiving swipes.