Amadis

OLA for Agnos through External Entry-Points

The following Compilation Option of ola_adapter.h allows use of Agnos Kernels through External Entry-Points:

#define OLA_OPTION_EXTERNAL_ENTRY_POINT

OLA API functions to be used with External Entry-Points are:

  • During Terminal Initialization

    • ola_initialize_at_start_up()

    • ola_pubkey_flush()

    • ola_pubkey_add()

  • For each Payment Transaction

    • ola_contactless_flush_aid_supported()

    • ola_emv_set_tag()

    • ola_contactless_add_aid_supported() (see ola_contactless_add_aid_supported() for configuring Kernels)

    • ola_contactless_do_transaction()

    • ola_contactless_get_outcome()

    • ola_emv_get_data()

    • ola_contactless_get_UI_request_upon_outcome() (when available)

    • ola_contactless_get_UI_request_restart() (when available)

    • ola_contactless_clean()

The following OLA API functions are irrelevant for use (i.e., shouldn’t be used) with External Entry-Points:

  • ola_contactless_preprocess()

  • ola_contactless_build_candidate_list()

  • ola_contactless_final_select_candidate()

Sample Flow

The following diagram shoes sample use of the OLA for Agnos API with External Entry-Points:

NOTE: Optionally if [Outcome Parameters] returned from ola_contactless_get_outcome() indicate presence of a UI Request Message on Outcome and/or UI Request message on Restart, the function/methods ola_contactless_get_UI_request_upon_outcome() and ola_contactless_get_UI_request_restart() can be used for retrieving corresponding UI Request informations