Table of Contents | ||
---|---|---|
|
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
...
Table of Contents | ||
---|---|---|
|
API _Version _Revision | Description |
---|---|
N/A | Callbacks are included in the different Agnos Framework components (AgnosEP, AgnosMW, Agnos, AgnosDB). Hence, their version depend on the components' versions their pertain to. |
AgnosEP | ||||||
---|---|---|---|---|---|---|
See entrypoint.h | ||||||
|
|
KernelSelectionMethod (entrypoint.h)
Name
KernelSelectionMethod
...
Contactless only. This call is performed right after PPSE selection. That callback can be used to overload mutual list management. Setter: enpSetApplicationSelectionMethod | |||||||
|
| Contactless 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. |
...
Setter: enpSetKernelSelectionMethod |
Setter
enpSetKernelSelectionMethod
Signature
...
AgnosMW | ||||||
---|---|---|---|---|---|---|
See dataxchng.h | ||||||
|
|
...
|
...
|
...
|
...
AgnosMW
emvcallback (dataxchng.h)
Name
emvCallback
...
| Contactless only. That callback can be used to control EMV contactless transaction flows. It is a normalized data exchange mechanism. |
...
Description
...
Itmay 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. DF12 shall be set in ENTRY POINT combinations. Example: DF12015A will trigger that callback call when 5A will be detected during the transaction flow. Setter |
...
: mDataExchange.mCallback |
...
in tPaymentContext structure Important: in order to enable this mechanism, set mDataExchange.mDEList in tPaymentContext with the adress |
...
of an instance of tDataExchangeList. |
...
Agnos | ||||||
---|---|---|---|---|---|---|
See agnos.h, agnostype.h | ||||||
|
|
...
|
...
Agnos
tGetDataCallback (agnostype.h)
Name
tGetDataCallback
...
| Contact and Contactless |
...
Description
. This callback shall be defined to control the EMV transaction flow at Agnos' Read Record state (AsRRD). Setter |
...
agnSetParsingCallback (see agnos.h)
Signature
typedef void (*tGetDataCallback)
(
tBoolean lastRead,
tBoolean *next
)
tBuildDOLCallback (agnostype.h)
Name
tBuildDOLCallback
Scope
Contactless only
Description
Reserved for contactless card processing applications.
Setter
agnSetBuildDOLCallback (see agnos.h)
Signature
typedef void (*tBuildDOLCallback)
(
tWord tag,
tByte length,
tByte *DOLData
)
tStateCallback (agnostype.h)
Name
tStateCallback
Scope
Contact and Contactless
Description
: agnSetParsingCallback | |||||||
|
| Contactless and Contactless. Setter: agnSetBuildDOLCallback | |||||
|
| Contactless and Contactless. This callback shall be defined to control the EMV transaction flow. It will be called at each state defined by Agnos (see tAgnosState in agnostype.h). Setter |
...
agnSetStateCallback (see agnos.h)
Signature
typedef void (*tStateCallback)
(
tAgnosState currentState,
tBoolean *stop,
tBoolean *bypass
)
AgnosDB
...
: agnSetStateCallback |
AgnosDB | ||
---|---|---|
See agnosdatabase.h |
...
Name
|
...
Scope
|
Description
Reserved for contactless card processing applications.
Setter
agnSetAddTagContactlessCallback (see agnosdatabase.h)
Signature
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Contactless |
...
Name
AddTag_contactless
Scope
Contactless
Description
only. This callback may be defined by a payment application to hook all the tag that are not statically supported by Agnos. Setter |
...
agnSetAddUnknownTagContactlessCallback (see agnosdatbase.h)
Signature
...
: agnSetAddTagContactlessCallback | ||||||
|
|
...
|
...
|
...
|
...
| Contactless only. Setter: agnSetAddUnknownTagContactlessCallback |