TransactionUpdate Callback

The Payment Device SDK fires transactionUpdate events as the customer progresses through the transaction. Each transaction update event describes the action that triggered the event, including EMV commands and data communication. The POS application can react to each event as needed, such as to update a display.

Methods to add or remove callback delegate in ChipDnaMobile:

void addTransactionUpdateListener(  
TmsUpdateListener listener  
)

void removeTransactionUpdateListener(  
TmsUpdateListener listener  
)

void addTransactionUpdateTarget:(id)self  
 action :(SEL)@selector (onTransactionUpdate:)

void removeTransactionUpdateTarget:(id)self

CardDetails Callback

When startTransaction() has been successfully called, the Payment Device SDK fires cardDetails events when the details are available. When getCardDetails() has been successfully called, the SDK fires a cardDetails event when the process is finished (instead of a transactionFinished event).

Methods to add or remove callback delegate in ChipDnaMobile:

void addCardDetailsListener(  
CardDetailsListener listener  
)  
void removeCardDetailsListener(  
CardDetailsListener listener  
)

void addCardDetailsTarget:(id)self  
   action :(SEL)@selector (onCardDetails:)

void removeCardDetailsTarget:(id)self

TransactionFinished Callback

After startTransaction() has been successfully called, the Payment Device SDK fires a transactionFinished callback when the transaction is finished. If the transaction is finished after the cardDetails callback is triggered, the transcationFinished parameters contains a parameter which will include the transaction result Approved or Declined and a receipt can be issued for the completed transaction. If the transaction is finished before the cardDetails callback, the parameters contain only the Errors parameter indicating the transaction has been terminated.

Methods to add or remove callback delegate in ChipDnaMobile:

void addTransactionFinishedListener(  
TransactionFinishedListener listener  
)

void removeTransactionFinishedListener(  
TransactionFinishedListener listener  
)

void addTransactionFinishedTarget:(id)self  
action :(SEL)@selector (onTransactionFinished:)

void removeTransactionFinishedTarget:(id)self

Transactions may be returned with the state Uncommitted, in which case it is the responsibility of the integrating application to call `confirmTransaction()`. Approved transactions must be confirmed for settlement in order to obtain the funds. If the funds for an approved transaction are not settled for reasons such as goods issue failure then the transaction should be voided.

ProcessReceiptFinished Callback

When processReceipt() has been successfully called, the Payment Device SDK fires a onProcessedReceiptFinished callback with the result of the request.

Methods to add or remove callback delegate in ChipDnaMobile:

void addProcessReceiptFinishedListener(  
ProcessReceiptFinishedListener listener  
)

void removeProcessReceiptFinishedListener(  
ProcessReceiptFinishedListener listener  
)

void addProcessReceiptCompleteTarget:(id)self  
 		action :(SEL)@selector (onProcessReceiptComplete:)

void removeProcessReceiptCompleteTarget:(id)self

SignatureVerification Callback

The Payment Device SDK fires a signatureVerification event, during a transaction, when the merchant needs to verify the cardholder signature. Call continueSignatureVerification() to set the signature verification result and continue the transaction. If digital signature is captured, the data should be sent to the SDK in a parameter in the continueSignatureVerification() method.

Methods to add or remove callback delegate in ChipDnaMobile:

void addSignatureVerificationListener(  
SignatureVerificationListener listener  
)

void removeSignatureVerificationListener(  
SignatureVerificationListener listener  
)

void addSignatureVerificationTarget:(id)self  
 	action :(SEL)@selector (onSignatureVerification:)
void removeSignatureVerificationTarget:(id)self

SignatureCapture Callback

The Payment Device SDK fires a SignatureCapture event during a transaction when a digital signature is required. Call continueSignatureCapture() to pass in digital signature data and continue the transaction.

Methods to add or removed callback delegate in ChipDnaMobile:

void addSignatureCaptureListener(  
	SignatureCaptureListener listener  
)  
Void removeSignatureCaptureListener(  
	SignatureCaptureListener listener  
)

void addSignatureCaptureTarget:(id)self  
			action:(SEL)@selector(onSignatureCapture:)  
void removeSignatureCaptureTarget:(id)self

ApplicationSelection Callback

The Payment Device SDK fires an applicationSelection event during a transaction when a customer is required to select the card application they wish to use for the transaction. Call continueApplicationSelection to pass the customers selection and continue the transaction.

Methods to add or removed callback delegate in ChipDnaMobile:

void addApplicationSelectionListener(  
	ApplicationSelectionListener listener  
)  
Void removeApplicationSelectionListener(  
	ApplicationSelectionListener listener  
)

void addApplicationSelectionTarget:(id)self  
			action:(SEL)@selector(onApplicationSelection:)  
void removeApplicationSelectionTarget:(id)self

UserNotification Callback

The Payment Device SDK fires a userNotification callback when a prompt is required to be shown to the customer. No integration call to the SDK is required to continue the transaction. The transaction will continue as normal.

Methods to add or removed callback delegate in ChipDnaMobile:

void addUserNotificationListener(  
	UserNotificationListener listener  
)  
Void removeUserNotificationListener(  
	UserNotificationListener listener  
)

void addUserNotificationTarget:(id)self  
			action:(SEL)@selector(onUserNotification:)  
void removeUserNotificationTarget:(id)self

void addUserNotificationListener(  
	UserNotificationListener listener  
)  
Void removeUserNotificationListener(  
	UserNotificationListener listener  
)

void addUserNotificationTarget:(id)self  
			action:(SEL)@selector(onUserNotification:)  
void removeUserNotificationTarget:(id)self