Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel2

Architecture

There are 8 callbacks available at different levels of Agnos Framework API:

...

AgnosEP

ApplicationSelectionMethod (entrypoint.h)

Name

ApplicationSelectionMethod

Scope

Contactless only. This call is performed right after PPSE selection. That callback can be used to overload mutual list management.

Description

Setter

enpSetApplicationSelectionMethod

Signature

Code Block
typedef tPaymentError (*ApplicationSelectionMethod)

...


(

...


tADFList *mutualList,

...

 // See Agnos/selection.h for structure definition
tByte *MLIndex,
tBoolean CL

...


)

KernelSelectionMethod (entrypoint.h)

Name

N/AKernelSelectionMethod

Scope

N/AContactless only. This call is performed when requested kernel ID cannot be determined by the entry point. That callback can be use to map an undertermined kernel ID to a supported kernel ID.

Description

N/A

Setter

N/AenpSetKernelSelectionMethod

Signature

...

Code Block
typedef tPaymentError (*ApplicationSelectionMethod)
(
tByte* kernelIdentifier, 
tByte kernelIdentifierLen,
tByte* requestedKernelIdentifier
)

AgnosMW

emvcallback (dataxchng.h)

Name

emvCallback

Scope

Contactless only. That callback can be used to control EMV contactless transaction flows. It is a normalized data exchange mechanism.

Description

This callback shall may be defined to control the contactless transaction flow from a payment application. It enables Data Exchange (DE) / Data Storage (DS) feature accross all contactless kernels in a normalized way. Use DF12 - Tags to Read - to define which tag(s) shall be looked up to give back control to the payment application.

Setter

Set tPaymentContext the field mDataExchange.mCallback defined by tPaymentContext. To enable DE/DS:

...

  • Set tPaymentContext mDataExchange.mDEList with the adress to an instance of

...

  • tDataExchangeList.

Signature

Code Block
typedef void (*emvcallback)

...


(

...


void* data

...


)

Agnos

tGetDataCallback (agnostype.h)

...

Contactless only

Description

Reserved for contactless card processing applications.

Setter

agnSetBuildDOLCallback (see agnos.h)

...

Scope

Contactless

Description

Reserved for contactless card processing applications.

Setter

agnSetAddTagContactlessCallback (see agnosdatabase.h)

...