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)
That call shall be performed once the system has been properly initialized (see AgnosMW API).
C Structures
Refer to AgnosMW API to get more details on tPaymentContext and tOutComeParameter.
Callbacks
typedef tPaymentError (*ApplicationSelectionMethod)(tADFList *mutualList, tByte *MLIndex, tBoolean CL)
typedef tBoolean (*KernelSelectionMethod)(tByte* kernelIdentifier, tByte kernelIdentifierLen, tByte* requestedKernelIdentifier)
Primitives
Names | Comments |
---|---|
enpInitialize | Set internal context to prepare the entry point |
enpConnectPaymentServices | Connect entry point onto available L2 CL kernels |
enpReleasePaymentServices | Broadcast afsRelease to all L2 CL kernels |
enpDisconnectPaymentServices | Disconnect entry point from connected L2 CL kernels |
enpExecutePaymentTransaction | Main point of entry to initiate a CL transaction tPaymentContext shall be set accordingly tOutcomeParameter provides final status Set sp to:
|
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 legacy selection rule for a given payment scheme |
enpAreAllCLApplicationNotAllowed | If not CL application selectable, provide a specific status so payment application may fallback to CT or magstrtipe |
enpGetPPSEFCI | PPSE’s FCI is store so payment application can fetch any proprietary tags like 9F0A (ASPRD) |