Amadis
Callbacks API
- Olivier Chauvineau (Unlicensed)
- Philippe Mesguen (Unlicensed)
Â
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 | ||
| typedef tPaymentError (*ApplicationSelectionMethod)
(
tADFList *mutualList, // See Agnos/selection.h for structure definition
tByte *MLIndex,
tBoolean CL
) | Contactless only. This call is performed right after PPSE selection. That callback can be used to overload mutual list management. Â Setter: enpSetApplicationSelectionMethod |
| typedef tPaymentError (*KernelSelectionMethod)
(
tByte* kernelIdentifier,
tByte kernelIdentifierLen,
tByte* requestedKernelIdentifier
) | 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 |
Â
AgnosMW | ||
|---|---|---|
See dataxchng.h | ||
| typedef void (*emvcallback)
(
void* data
) | Contactless only. That callback can be used to control EMV contactless transaction flows. It is a normalized data exchange mechanism. 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 | ||
| Contact and Contactless. This callback shall be defined to control the EMV transaction flow at Agnos' Read Record state (AsRRD). Â Setter: 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 | |
Â
AgnosDB | ||
|---|---|---|
See agnosdatabase.h | ||
| Contactless only. This callback may be defined by a payment application to hook all the tag that are not statically supported by Agnos. Â Setter: agnSetAddTagContactlessCallback | |
| Contactless only. Â Setter: agnSetAddUnknownTagContactlessCallback | |
Â