![]() |
IDTech iOS/OSX SDK Guide
1.1.084
API reference for UniPay 1.5
|
The methods below are provided as a reference to the main commands needed to execute a contact or contactless EMV transaction, or collect MSR information from a swipe.
Begins an amount authorization request with the ICC. Returns authorization decision (approved, denied, or go online) in delegate method.
IDT_UniPayI_V::emv_authenticateTransaction()
By default, auto-authenticate is ON and this step does not need to be performed. If auto-authenticate is OFF (emv_disableAutoAuthenticateTransaction: (IDT_UniPayI_V)), when the results come back as EMV_RESULT_CODE.EMV_RESULT_CODE_AUTHENTICATE_TRANSACTION, this method must be called to continue the EMV transaction.
After receiving a host response, pass host tags (minimum 8A Authorization Response Code) as a TLV stream 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.
Methods for AID management on Contact EMV. When setting the AID, you pass tags in TLV format. When retrieving AID, you can receive the results as tags in TLV format. When retrieving the AID list, the list of AID Names/length can be retrieved from the NSArray of NSString.
Methods for Certificate Authority Public Key management. When setting the CAPK, you populate and pass the key as a sequence of ordered bytes. When specifying a CAPK to retrieve or remove, you populate the name in the NSData parameter. When retrieving the CAPK list, the list of RID/Index can be retrieved from the ordered NSData stream, 6 bytes each, bytes 1-5 RID, byte 6 index.
Methods for Certificate Revocation List management.