IDTech iOS/OSX SDK Guide  1.1.052
API reference for BTPay 200
 All Data Structures Functions Variables Properties Pages
<IDT_BTPay_Delegate> Protocol Reference

#import <IDT_BTPay.h>

Inheritance diagram for <IDT_BTPay_Delegate>:

Instance Methods

(void) - deviceConnected
 Fires when device connects. If a connection is established before the delegate is established (no delegate to send initial connection notification to), this method will fire upon establishing the delegate.
 
(void) - deviceDisconnected
 Fires when device disconnects.
 
(void) - dataInOutMonitor:incoming:
 
(void) - swipeMSRData:
 
(void) - emvTransactionData:errorCode:
 
(void) - pinpadData:keySN:event:
 

Detailed Description

Protocol methods established for IDT_BTPay class

Method Documentation

- (void) dataInOutMonitor: (NSData *)  data
incoming: (BOOL)  isIncoming 
optional

All incoming/outgoing data going to the device can be monitored through this delegate.

Parameters
dataThe serial data represented as a NSData object
isIncomingThe direction of the data
  • TRUE specifies data being received from the device,
  • FALSE indicates data being sent to the device.
- (void) emvTransactionData: (IDTEMVData *)  emvData
errorCode: (int)  error 
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
- (void) pinpadData: (NSData *)  value
keySN: (NSData *)  KSN
event: (EVENT_PINPAD_Types)  event 
optional

Pinpad data delegate protocol

Receives data from pinpad methods

Parameters
valueencrypted data returned from pin_getEncryptedData:minLength:maxLength:messageID:language: (IDT_BTPay), or encrypted account number returned from pin_getCardAccount:max:line1:line2: (IDT_BTPay). String value returned from pin_getAmount:maxLength:messageID:language: (IDT_BTPay) or pin_getNumeric:minLength:maxLength:messageID:language: (IDT_BTPay). PINblock returned from pin_getEncryptedPIN:keyType:line1:line2:line3: (IDT_BTPay)
KSNKey Serial Number returned from pin_getEncryptedPIN:keyType:line1:line2:line3: (IDT_BTPay), pin_getCardAccount:max:line1:line2: (IDT_BTPay) or pin_getEncryptedData:minLength:maxLength:messageID:language: (IDT_BTPay)
eventEVENT_PINPAD_Types PINpad event that solicited the data capture
typedef enum{
EVENT_PINPAD_UNKNOWN = 11,
EVENT_PINPAD_ENCRYPTED_PIN,
EVENT_PINPAD_NUMERIC,
EVENT_PINPAD_AMOUNT,
EVENT_PINPAD_ACCOUNT,
EVENT_PINPAD_ENCRYPTED_DATA,
EVENT_PINPAD_CANCEL,
EVENT_PINPAD_TIMEOUT,
EVENT_PINPAD_FUNCTION_KEY,
EVENT_PINPAD_DATA_ERROR
}EVENT_PINPAD_Types;
- (void) swipeMSRData: (IDTMSRData *)  cardData
optional

Receives card data from MSR swipe.

Parameters
cardDataCaptured card data from MSR swipe

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