...
AgnosEP provides the main point of entry to initiate EMV transactions for CL acceptance system (enpExecutePaymentTransaction). It shall be called from the payment application which shall manage two structures:
tPaymentContext (in/out)
tOutComeParameter (out)
Each time a new transaction is triggered these two structures shall be initialized (see
That call shall be performed once the system has been properly initialized (see AgnosMW API).
Table of Contents |
---|
C Structures
Refer to AgnosMW API to get more details on tPaymentContext and tOutComeParameter.
Primitives
...
Names
...
Comments
...
enpInitialize
...
Set internal context to prepare the entry point. This call shall be performed only when the system is cycled up
...
Table of Contents | ||
---|---|---|
|
API _Version _Revision | Description |
---|---|
_AgnosEP _version 3.5.23 _revision 23782 | Agnos EP Interface provides a set of primitives to manage EMV contactless card processing. It encapsulates EMVCo Book A and B. |
...
Agnos Entry Point | |||||||
---|---|---|---|---|---|---|---|
See entrypoint.h, loader.h | |||||||
|
| -- | |||||
|
| Callback definition. Called after PPSE selection if defined | |||||
|
| Callback definition. Called during combination selection if defined | |||||
|
| Connect entry point onto available L2 CL kernels. This call shall be performed only when the system is cycled up | |||||
|
enpReleasePaymentServices
Broadcast afsRelease to all L2 CL kernels. This call shall be performed only when the system is cycled down.
| Disconnect entry point from connected L2 CL kernels. This call shall be performed only when the system is cycled up | |||||
|
|
enpExecutePaymentTransaction
Main point of entry to initiate a CL transaction.
tPaymentContext shall be set accordingly
tOutcomeParameter provides final status
Set sp to:
spSTART_A: to initiate a new transaction
spSTART_D: to activate the kernel used for the current transaction
spNO_START: to clean the context
enpSetPollingTimeout
Set time used during gpiPolling to detect a card presentation
enpSkipPollingOnNextStartB
When gpiPolling is performed from outside the entry point, skip gpiPolling call from inside the entry point to avoid double tap
enpSetKernelSelectionMethod
N/A
enpSetApplicationSelectionMethod
Set callback hooked after PPSE selection
enpSetLegacyXXXStatus
| Set internal context to prepare the entry point for the subsequent transaction
Important: Prior to that call:
| ||||||||||||||||||||||||||||||||||||
|
| Enable legacy selection rule for a given payment scheme. Payment schemes' specifications, outside Book Cx, use selection rules that might differ for error management. it is important to set appropriate flag duting TA |
enpAreAllCLApplicationNotAllowed
|
| Set timeout value used during gpiPolling to detect a card presentation | |||||
|
| Indicate to the entry point that the online transaction has timed out and consequently the long tap has timed out | |||||
|
| Return timeout value used during gpiPolling to detect a card presentation | |||||
|
| Deprecated | |||||
|
| Return PPSE’s FCI stored at PPSE selection so payment application can fetch any proprietary tags (for example, tag 9F0A, ASPRD). If SW1SW2 is defined then the entry point returns the status word | |||||
|
| Return the mutual list calculated at PPSE selection time. See Agnos and Selection module to get details on tADFList | |||||
|
| Return bTRUE if there is no elligible contactless application after preprocessing. If no CL application is |
elligible, provide a specific status so payment application |
may fallback to |
contact or |
magstripe depeding on interfaces supported by the device |
enpGetPPSEFCI
PPSE’s FCI is stored so payment application can fetch any proprietary tags like 9F0A (example: ASPRD)
Examples
|
| Reset corresponding state | |||||
|
| Return the last gpiPolling error obtain at the last START_B | |||||
|
| When gpiPolling is performed from outside the entry point, skip gpiPolling call from inside the entry point to avoid double tap | |||||
|
| Broadcast afsRelease to all L2 CL kernels. This call shall be performed only when the system is cycled down. | |||||
|
| Main point of entry to initiate a CL transaction. tPaymentContext shall be set accordingly tOutcomeParameter provides final status in lign with L2 TA’s test plans Set sp to:
| |||||
|
| ||||||
|
|
Code Example | |||||
---|---|---|---|---|---|
See entrypoint.h | |||||
|
...
|
...