TIM SDK
TIM API C
terminal.h File Reference

Description

Terminal.

Object type terminal.

Note
In contrary to other object types getter functions for the object type terminal retains object instances returned to the caller.
Once a terminal object instance has been disposed all future function calls will fail with error ta_c_rc_invalid_argument.
Terminal object instances operate using internal multi-threading structures. Always call setter and action functions on the terminal object instances from the main application thread. Never call these functions from inside terminal_listener callbacks. If you need to call such functions in response to terminal events you have to delay the function calls to be issued on the main thread. Main thread in this context means the one and only thread issuing these kinds of function calls. Getter functions on the other hand can be used during terminal_listener callbacks.

Functions

const char * ta_terminal_get_tim_api_version (void)
 Tim Api Build Version.
 
ta_e_result_code_t ta_terminal_create (ta_object_t *terminal, ta_object_t settings)
 Create terminal instance. More...
 
ta_e_result_code_t ta_terminal_dispose (ta_object_t terminal)
 Dispose of terminal. More...
 
ta_e_result_code_t ta_terminal_get_settings (ta_object_t terminal, ta_object_t *settings)
 Immutable terminal settings. More...
 
ta_e_result_code_t ta_terminal_get_terminal_id (ta_object_t terminal, ta_object_t *terminal_id)
 Terminal identifier of connected terminal. More...
 
ta_e_result_code_t ta_terminal_get_pos_id (ta_object_t terminal, ta_object_t *pos_id)
 POS identifier. More...
 
ta_e_result_code_t ta_terminal_set_pos_id (ta_object_t terminal, ta_object_t pos_id)
 Set POS identifier. More...
 
ta_e_result_code_t ta_terminal_get_user_id (ta_object_t terminal, int *user_id)
 User identifier. More...
 
ta_e_result_code_t ta_terminal_set_user_id (ta_object_t terminal, int user_id)
 Set User identifier. More...
 
ta_e_result_code_t ta_terminal_get_ecr_data (ta_object_t terminal, ta_object_t *ecr_data)
 ECR Data. More...
 
ta_e_result_code_t ta_terminal_set_ecr_data (ta_object_t terminal, ta_object_t ecr_data)
 Set ECR Data. More...
 
ta_e_result_code_t ta_terminal_add_ecr_data (ta_object_t terminal, ta_object_t ecr_info)
 Add ECR data replacing existing one if present. More...
 
ta_e_result_code_t ta_terminal_get_allowed_third_party_apps (ta_object_t terminal, int *allowed_third_party_apps)
 Allowed third party apps. More...
 
ta_e_result_code_t ta_terminal_set_allowed_third_party_apps (ta_object_t terminal, int allowed_third_party_apps)
 Set allowed third party apps. More...
 
ta_e_result_code_t ta_terminal_get_print_options (ta_object_t terminal, ta_object_t *print_options)
 Print options. More...
 
ta_e_result_code_t ta_terminal_set_print_options (ta_object_t terminal, ta_object_t print_options)
 Set Print options. More...
 
ta_e_result_code_t ta_terminal_get_merchant_options (ta_object_t terminal, ta_object_t *merchant_options)
 Merchant options. More...
 
ta_e_result_code_t ta_terminal_set_merchant_options (ta_object_t terminal, ta_object_t merchant_options)
 Set Merchant options. More...
 
ta_e_result_code_t ta_terminal_get_customer_data (ta_object_t terminal, ta_object_t *customer_data)
 Customer data. More...
 
ta_e_result_code_t ta_terminal_set_customer_data (ta_object_t terminal, ta_object_t customer_data)
 Set Customer data. More...
 
ta_e_result_code_t ta_terminal_get_transaction_data (ta_object_t terminal, ta_object_t *transaction_data)
 Transaction data to use for transaction requests unless set manually. More...
 
ta_e_result_code_t ta_terminal_set_transaction_data (ta_object_t terminal, ta_object_t transaction_data)
 Set transaction data to use for transaction requests unless set manually. More...
 
ta_e_result_code_t ta_terminal_get_receipt_formatter (ta_object_t terminal, ta_object_t *formatter)
 Receipt formatter. More...
 
ta_e_result_code_t ta_terminal_set_receipt_formatter (ta_object_t terminal, ta_object_t formatter)
 Set receipt formatter. More...
 
ta_e_result_code_t ta_terminal_get_terminal_status (ta_object_t terminal, ta_object_t *terminal_status)
 Get terminal status. More...
 
ta_e_result_code_t ta_terminal_get_brands (ta_object_t terminal, ta_object_t *brands)
 Get brands or 0 if not retrieved yet. More...
 
ta_e_result_code_t ta_terminal_get_features (ta_object_t terminal, ta_s_features_t *features, ta_e_boolean_t *has_features)
 Get features if known. More...
 
ta_e_result_code_t ta_terminal_get_supported_languages (ta_object_t terminal, ta_object_t *languages)
 Get supported languages or ta_object_invalid if unknown. More...
 
ta_e_result_code_t ta_terminal_get_act_seq_counter (ta_object_t terminal, int *act_seq_counter)
 Activation sequence counter. More...
 
ta_e_result_code_t ta_terminal_get_config_data (ta_object_t terminal, ta_object_t *config_data)
 Get configuration data. More...
 
ta_e_result_code_t ta_terminal_get_license (ta_object_t terminal, ta_object_t *license)
 Supported licensed features as 8 bytes hex encoded bitmap. More...
 
ta_e_result_code_t ta_terminal_activate (ta_object_t terminal, ta_object_t *response)
 Opens a user shift. More...
 
ta_e_result_code_t ta_terminal_activate_async (ta_object_t terminal)
 Opens a user shift. More...
 
ta_e_result_code_t ta_terminal_application_information (ta_object_t terminal)
 Requests the list of brands available on the terminal. More...
 
ta_e_result_code_t ta_terminal_application_information_async (ta_object_t terminal)
 Requests the list of brands available on the terminal. More...
 
ta_e_result_code_t ta_terminal_balance (ta_object_t terminal, ta_object_t *response)
 Forces the EFT Terminal to transmit all transactions to the host system as well to do the daily closing. More...
 
ta_e_result_code_t ta_terminal_balance_async (ta_object_t terminal)
 Forces the EFT Terminal to transmit all transactions to the host system as well to do the daily closing. More...
 
ta_e_result_code_t ta_terminal_cancel (ta_object_t terminal)
 Aborts an open asynchronous Financial Transaction or Non-Financial Transaction request, except for a ta_terminal_commit or ta_terminal_rollback_async request, which cannot be cancelled. More...
 
ta_e_result_code_t ta_terminal_cancel2 (ta_object_t terminal, ta_e_boolean_t silent, ta_e_boolean_t retain_card)
 Aborts an open asynchronous Financial Transaction or Non-Financial Transaction request, except for a ta_terminal_commit or ta_terminal_rollback_async request, which cannot be cancelled. More...
 
ta_e_result_code_t ta_terminal_change_settings (ta_object_t terminal, ta_object_t settings)
 Changes configuration parameters of the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_change_settings_async (ta_object_t terminal, ta_object_t settings)
 Changes configuration parameters of the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_commit (ta_object_t terminal)
 Performs Commit-operation after a successful Transaction call. More...
 
ta_e_result_code_t ta_terminal_commit_async (ta_object_t terminal)
 Performs Commit-operation after a successful Transaction call. More...
 
ta_e_result_code_t ta_terminal_commit_amount (ta_object_t terminal, ta_object_t amount, ta_object_t *response)
 Performs Commit-operation after a successful Transaction call. More...
 
ta_e_result_code_t ta_terminal_commit_amount_async (ta_object_t terminal, ta_object_t amount)
 Performs Commit-operation after a successful Transaction call. More...
 
ta_e_result_code_t ta_terminal_connect (ta_object_t terminal)
 Initiates a connection to the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_connect_async (ta_object_t terminal)
 Initiates a connection to the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_counter_request (ta_object_t terminal, ta_e_counter_type_t counter_type, ta_object_t *response)
 Get counter information's from the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_counter_request_async (ta_object_t terminal, ta_e_counter_type_t counter_type)
 Get counter information's from the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_deactivate (ta_object_t terminal, ta_object_t *response)
 Closes a user shift. More...
 
ta_e_result_code_t ta_terminal_deactivate_async (ta_object_t terminal)
 Closes a user shift. More...
 
ta_e_result_code_t ta_terminal_disconnect (ta_object_t terminal)
 Interrupts the connection to the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_disconnect_async (ta_object_t terminal)
 Interrupts the connection to the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_dcc_rates (ta_object_t terminal, ta_object_t *response)
 Requests DCC rates from the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_dcc_rates_async (ta_object_t terminal)
 Requests DCC rates from the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_hardware_information (ta_object_t terminal, ta_object_t *response)
 Get hardware information from the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_hardware_information_async (ta_object_t terminal)
 Get hardware information from the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_init_transaction (ta_object_t terminal, ta_e_boolean_t display_amount, ta_object_t amount, ta_object_t *response)
 Initialize a transaction knowing the amount or the card type. More...
 
ta_e_result_code_t ta_terminal_init_transaction2 (ta_object_t terminal, ta_e_boolean_t display_amount, ta_object_t amount, ta_e_function_hint_t function_hint, ta_object_t *response)
 Initialize a transaction knowing the amount or the card type. More...
 
ta_e_result_code_t ta_terminal_init_transaction_async (ta_object_t terminal, ta_e_boolean_t display_amount, ta_object_t amount)
 Initialize a transaction knowing the amount or the card type. More...
 
ta_e_result_code_t ta_terminal_init_transaction2_async (ta_object_t terminal, ta_e_boolean_t display_amount, ta_object_t amount, ta_e_function_hint_t function_hint)
 Initialize a transaction knowing the amount or the card type. More...
 
ta_e_result_code_t ta_terminal_client_identification (ta_object_t terminal, ta_object_t *response)
 Starts an EFT Client Identification. More...
 
ta_e_result_code_t ta_terminal_client_identification_async (ta_object_t terminal)
 Starts an EFT Client Identification. More...
 
ta_e_result_code_t ta_terminal_init_transaction_with_dialog (ta_object_t terminal, ta_object_t amount, ta_e_function_hint_t function_hint, ta_object_t dialog, ta_object_t *response)
 Initialize a transaction with dialog. More...
 
ta_e_result_code_t ta_terminal_init_transaction_with_dialog_async (ta_object_t terminal, ta_object_t amount, ta_e_function_hint_t function_hint, ta_object_t dialog)
 Initialize a transaction with dialog. More...
 
ta_e_result_code_t ta_terminal_login (ta_object_t terminal)
 Activate a communication session between the ECR and the terminal. More...
 
ta_e_result_code_t ta_terminal_login_async (ta_object_t terminal)
 Activate a communication session between the ECR and the terminal. More...
 
ta_e_result_code_t ta_terminal_logout (ta_object_t terminal)
 Terminates an active communication session between the ECR and the terminal. More...
 
ta_e_result_code_t ta_terminal_logout_async (ta_object_t terminal)
 Terminates an active communication session between the ECR and the terminal. More...
 
ta_e_result_code_t ta_terminal_reboot (ta_object_t terminal)
 Force the EFT Terminal to reboot. More...
 
ta_e_result_code_t ta_terminal_reboot_async (ta_object_t terminal)
 Force the EFT Terminal to reboot. More...
 
ta_e_result_code_t ta_terminal_reconciliation (ta_object_t terminal, ta_object_t *response)
 Force the EFT Terminal to transmit all financial transactions to the host system. More...
 
ta_e_result_code_t ta_terminal_reconciliation_async (ta_object_t terminal)
 Force the EFT Terminal to transmit all financial transactions to the host system. More...
 
ta_e_result_code_t ta_terminal_receipt_request (ta_object_t terminal, ta_e_receipt_request_type_t type, ta_object_t *response)
 Receive the latest receipt or a list of silent receipts. More...
 
ta_e_result_code_t ta_terminal_receipt_request_async (ta_object_t terminal, ta_e_receipt_request_type_t type)
 Receive the latest receipt or a list of silent receipts. More...
 
ta_e_result_code_t ta_terminal_transaction_info_request (ta_object_t terminal, ta_object_t *response)
 Receive the latest transaction information. More...
 
ta_e_result_code_t ta_terminal_transaction_info_request_async (ta_object_t terminal)
 Receive the latest transaction information. More...
 
ta_e_result_code_t ta_terminal_reconfig (ta_object_t terminal, ta_object_t *response)
 Force the EFT Terminal to get the configuration from the service center. More...
 
ta_e_result_code_t ta_terminal_reconfig_async (ta_object_t terminal)
 Force the EFT Terminal to get the configuration from the service center. More...
 
ta_e_result_code_t ta_terminal_rollback (ta_object_t terminal, ta_object_t *response)
 Prevents a transaction from being committed to the transaction log and generates a technical reversal of the authorization. More...
 
ta_e_result_code_t ta_terminal_rollback_async (ta_object_t terminal)
 Prevents a transaction from being committed to the transaction log and generates a technical reversal of the authorization. More...
 
ta_e_result_code_t ta_terminal_software_update (ta_object_t terminal, ta_e_update_status_t *response)
 Force the EFT Terminal to start a Software Update. More...
 
ta_e_result_code_t ta_terminal_software_update_async (ta_object_t terminal)
 Force the EFT Terminal to start a Software Update. More...
 
ta_e_result_code_t ta_terminal_system_information (ta_object_t terminal, ta_object_t *response)
 Request system information from the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_system_information_async (ta_object_t terminal)
 Request system information from the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_transaction (ta_object_t terminal, ta_e_transaction_type_t type, ta_object_t amount, ta_object_t *response)
 Starts an EFT Terminal Transaction. More...
 
ta_e_result_code_t ta_terminal_transaction_async (ta_object_t terminal, ta_e_transaction_type_t type, ta_object_t amount)
 Starts an EFT Terminal Transaction. More...
 
ta_e_result_code_t ta_terminal_transaction2 (ta_object_t terminal, ta_e_transaction_type_t type, ta_object_t request, ta_object_t *response)
 Starts an EFT Terminal Transaction. More...
 
ta_e_result_code_t ta_terminal_transaction2_async (ta_object_t terminal, ta_e_transaction_type_t type, ta_object_t request)
 Starts an EFT Terminal Transaction. More...
 
ta_e_result_code_t ta_terminal_transaction_tip (ta_object_t terminal, ta_e_transaction_type_t type, ta_object_t amount, ta_object_t amount_tip, ta_object_t *response)
 Starts an EFT Terminal Transaction. More...
 
ta_e_result_code_t ta_terminal_transaction_tip_async (ta_object_t terminal, ta_e_transaction_type_t type, ta_object_t amount, ta_object_t amount_tip)
 Starts an EFT Terminal Transaction. More...
 
ta_e_result_code_t ta_terminal_transaction_cashback (ta_object_t terminal, ta_e_transaction_type_t type, ta_object_t amount, ta_object_t amount_cashback, ta_object_t *response)
 Starts an EFT Terminal Transaction. More...
 
ta_e_result_code_t ta_terminal_transaction_cashback_async (ta_object_t terminal, ta_e_transaction_type_t type, ta_object_t amount, ta_object_t amount_cashback)
 Starts an EFT Terminal Transaction. More...
 
ta_e_result_code_t ta_terminal_close_reader (ta_object_t terminal)
 Close the shutter of the card reader. More...
 
ta_e_result_code_t ta_terminal_close_reader_async (ta_object_t terminal)
 Close the shutter of the card reader. More...
 
ta_e_result_code_t ta_terminal_open_reader (ta_object_t terminal)
 Open the shutter of the card reader. More...
 
ta_e_result_code_t ta_terminal_open_reader_async (ta_object_t terminal)
 Open the shutter of the card reader. More...
 
ta_e_result_code_t ta_terminal_eject_card (ta_object_t terminal)
 Eject a card from the card reader. More...
 
ta_e_result_code_t ta_terminal_eject_card_async (ta_object_t terminal)
 Eject a card from the card reader. More...
 
ta_e_result_code_t ta_terminal_open_maintenance_window (ta_object_t terminal)
 Opens the maintenance window to the terminal so it can perform collected maintenance requests on its own, without interaction with the ECR. More...
 
ta_e_result_code_t ta_terminal_open_maintenance_window_async (ta_object_t terminal)
 Opens the maintenance window to the terminal so it can perform collected maintenance requests on its own, without interaction with the ECR. More...
 
ta_e_result_code_t ta_terminal_close_maintenance_window (ta_object_t terminal)
 Closes the maintenance window to the terminal so it can perform collected maintenance requests on its own, without interaction with the ECR. More...
 
ta_e_result_code_t ta_terminal_close_maintenance_window_async (ta_object_t terminal)
 Closes the maintenance window to the terminal so it can perform collected maintenance requests on its own, without interaction with the ECR. More...
 
ta_e_result_code_t ta_terminal_hold_commit (ta_object_t terminal)
 Extends the Commit timeout if the terminal needs additional time before the Commit shall be performed. More...
 
ta_e_result_code_t ta_terminal_activate_service_menu (ta_object_t terminal)
 Activate service menu. More...
 
ta_e_result_code_t ta_terminal_activate_service_menu_async (ta_object_t terminal)
 Activate service menu. More...
 
ta_e_result_code_t ta_terminal_amt_adjustment (ta_object_t terminal, ta_object_t amount)
 Dynamically adjusts the transaction amount of an already running transaction. More...
 
ta_e_result_code_t ta_terminal_amt_adjustment_2 (ta_object_t terminal, ta_object_t amount, ta_object_t amount_discount, ta_object_t loyalty_coupon_list, ta_object_t loyalty_information_list)
 Dynamically adjusts the transaction amount of an already running transaction. More...
 
ta_e_result_code_t ta_terminal_loyalty_data (ta_object_t terminal, ta_e_loyalty_function_type_t function_type, ta_object_t data_type, ta_object_t data, ta_e_boolean_t retain_card, ta_object_t *response)
 This function is used to query and configure loyalty information. More...
 
ta_e_result_code_t ta_terminal_loyalty_data_async (ta_object_t terminal, ta_e_loyalty_function_type_t function_type, ta_object_t data_type, ta_object_t data, ta_e_boolean_t retain_card)
 This function is used to query and configure loyalty information. More...
 
ta_e_result_code_t ta_terminal_start_checkout (ta_object_t terminal)
 This function is used to start a Checkout process at the POS to collect card and/or cardholder loyalty information before a transaction is started. More...
 
ta_e_result_code_t ta_terminal_start_checkout_async (ta_object_t terminal)
 This function is used to start a Checkout process at the POS to collect card and/or cardholder loyalty information before a transaction is started. More...
 
ta_e_result_code_t ta_terminal_finish_checkout (ta_object_t terminal, ta_object_t *response)
 This function is used to finish a previously started checkout process with StartCheckout and to retrieve consumer loyalty data from the terminal that has been collected during this checkout process. More...
 
ta_e_result_code_t ta_terminal_finish_checkout_async (ta_object_t terminal)
 This function is used to finish a previously started checkout process with StartCheckout and to retrieve consumer loyalty data from the terminal that has been collected during this checkout process. More...
 
ta_e_result_code_t ta_terminal_provide_loyalty_basket (ta_object_t terminal, ta_object_t basket, ta_object_t *response)
 This function is used to provide the terminal with a LoyaltyBasket if the corresponding loyalty scheme requires it. More...
 
ta_e_result_code_t ta_terminal_provide_loyalty_basket_async (ta_object_t terminal, ta_object_t basket)
 This function is used to provide the terminal with a LoyaltyBasket if the corresponding loyalty scheme requires it. More...
 
ta_e_result_code_t ta_terminal_provide_vas_result (ta_object_t terminal, ta_object_t result, ta_object_t *response)
 This function is used to provide the terminal with a LoyaltyBasket if the corresponding loyalty scheme requires it. More...
 
ta_e_result_code_t ta_terminal_provide_vas_result_async (ta_object_t terminal, ta_object_t result)
 This function is used to provide the terminal with a LoyaltyBasket if the corresponding loyalty scheme requires it. More...
 
ta_e_result_code_t ta_terminal_mobile_topup_issuer_info (ta_object_t terminal, ta_object_t *response)
 Request Mobile Topup Issuer information. More...
 
ta_e_result_code_t ta_terminal_mobile_topup_issuer_info_async (ta_object_t terminal)
 Request Mobile Topup Issuer information. More...
 
ta_e_result_code_t ta_terminal_mobile_topup (ta_object_t terminal, ta_e_mobile_topup_type_t type, ta_object_t issuer_name, ta_object_t amount, ta_object_t *response)
 Mobile Topup transaction. Supported transaction type are PURCHASE and REVERSAL. More...
 
ta_e_result_code_t ta_terminal_mobile_topup2 (ta_object_t terminal, ta_e_mobile_topup_type_t type, ta_object_t value, ta_object_t *response)
 Mobile Topup transaction. Supported transaction type are PURCHASE and REVERSAL. More...
 
ta_e_result_code_t ta_terminal_mobile_topup_async (ta_object_t terminal, ta_e_mobile_topup_type_t type, ta_object_t issuer_name, ta_object_t amount)
 Mobile Topup transaction. Supported transaction type are PURCHASE and REVERSAL. More...
 
ta_e_result_code_t ta_terminal_mobile_topup2_async (ta_object_t terminal, ta_e_mobile_topup_type_t type, ta_object_t value)
 Mobile Topup transaction. Supported transaction type are PURCHASE and REVERSAL. More...
 
ta_e_result_code_t ta_terminal_open_dialog_mode (ta_object_t terminal)
 Open dialog mode on the terminal. More...
 
ta_e_result_code_t ta_terminal_open_dialog_mode2 (ta_object_t terminal, ta_e_boolean_t silent)
 Open dialog mode on the terminal. More...
 
ta_e_result_code_t ta_terminal_open_dialog_mode_async (ta_object_t terminal)
 Open dialog mode on the terminal. More...
 
ta_e_result_code_t ta_terminal_open_dialog_mode2_async (ta_object_t terminal, ta_e_boolean_t silent)
 Open dialog mode on the terminal. More...
 
ta_e_result_code_t ta_terminal_close_dialog_mode (ta_object_t terminal)
 Close dialog mode on the terminal. More...
 
ta_e_result_code_t ta_terminal_close_dialog_mode_async (ta_object_t terminal)
 Close dialog mode on the terminal. More...
 
ta_e_result_code_t ta_terminal_show_signature_capture (ta_object_t terminal, ta_object_t request, ta_object_t *response)
 Show signature capture on the terminal. More...
 
ta_e_result_code_t ta_terminal_show_signature_capture_async (ta_object_t terminal, ta_object_t request)
 Request system information from the EFT Terminal. More...
 
ta_e_result_code_t ta_terminal_show_dialog (ta_object_t terminal, ta_object_t request, ta_object_t *response)
 Show dialog on the terminal. More...
 
ta_e_result_code_t ta_terminal_show_dialog_async (ta_object_t terminal, ta_object_t request)
 Show dialog on the terminal. More...
 
ta_e_result_code_t ta_terminal_print_on_terminal (ta_object_t terminal, ta_object_t ticket_data)
 The PrintOnTerminal-function is used to send a freetext preformatted ticket from ECR to terminal. More...
 
ta_e_result_code_t ta_terminal_print_on_terminal_async (ta_object_t terminal, ta_object_t ticket_data)
 The PrintOnTerminal-function is used to send a freetext preformatted ticket from ECR to terminal. More...
 
ta_e_result_code_t ta_terminal_send_card_command (ta_object_t terminal, ta_object_t requests, ta_object_t *responses)
 Send card command. More...
 
ta_e_result_code_t ta_terminal_send_card_command_async (ta_object_t terminal, ta_object_t requests)
 Send card command. More...
 
ta_e_result_code_t ta_terminal_balance_inquiry (ta_object_t terminal, ta_object_t *response)
 Get information about the current account balance of the inserted card. More...
 
ta_e_result_code_t ta_terminal_balance_inquiry_async (ta_object_t terminal)
 Get information about the current account balance of the inserted card. More...
 
ta_e_result_code_t ta_terminal_request_alias (ta_object_t terminal, ta_object_t six_trans_ref, ta_object_t *response)
 The RequestAlias-function is used to request a Saferpay Alias for Alias-based transactions. More...
 
ta_e_result_code_t ta_terminal_request_alias_async (ta_object_t terminal, ta_object_t six_trans_ref)
 The RequestAlias-function is used to request a Saferpay Alias for Alias-based transactions. More...
 
ta_e_result_code_t ta_terminal_device_maintenance (ta_object_t terminal, ta_e_maintenance_type_t type)
 Perform device maintenance. More...
 
ta_e_result_code_t ta_terminal_device_maintenance_async (ta_object_t terminal, ta_e_maintenance_type_t type)
 Perform device maintenance. More...
 
ta_e_result_code_t ta_terminal_screenshot (ta_object_t terminal)
 Send notification to request EFT make a screenshot. More...
 
ta_e_result_code_t ta_terminal_third_party_app_data (ta_object_t terminal, ta_object_t data)
 Send third_party_app_data to request EFT make a screenshot. More...
 
ta_e_result_code_t ta_terminal_change_language_for_request (ta_object_t terminal, ta_object_t language)
 The ChangeLanguage-notification changes the current cardholder language of the EFT. More...
 
ta_e_result_code_t ta_terminal_age_check (ta_object_t terminal, ta_object_t age_to_check, ta_object_t *response)
 This function is used to start an age check on the terminal. More...
 
ta_e_result_code_t ta_terminal_age_check_async (ta_object_t terminal, ta_object_t age_to_check)
 This function is used to start an age check on the terminal. More...
 
ta_e_result_code_t ta_terminal_can_dcc (ta_object_t terminal, ta_e_boolean_t *result)
 Returns true if at least one payment protocol and the terminal configuration offer DCC i.e. if there is a chance to do a DCC transaction. More...
 
ta_e_result_code_t ta_terminal_can_declined_receipts (ta_object_t terminal, ta_e_boolean_t *result)
 Support for "Declined Receipts" in at least one payment protocol. More...
 
ta_e_result_code_t ta_terminal_can_multi_account_selection (ta_object_t terminal, ta_e_boolean_t *result)
 Support for multiple account selection. More...
 
ta_e_result_code_t ta_terminal_has_sw_update (ta_object_t terminal, ta_e_boolean_t *result)
 Software update is available. More...
 
ta_e_result_code_t ta_terminal_get_item_textcode (ta_object_t terminal, int item_text_code, ta_e_additional_info_item_t *result)
 Convert item text code to AdditionalInfoItem value. More...
 
ta_e_result_code_t ta_terminal_get_item_textcode_description (ta_object_t terminal, ta_e_additional_info_item_t item, const char **result)
 Get text description of AdditionalInfoItem. More...
 
ta_e_result_code_t ta_terminal_convert_six_trans_ref_to_legacy (ta_object_t six_trans_ref, ta_object_t *result)
 This function tries to convert a SIXTransRef of type X:Y:4 into A SIXTransRef of type X:Y:1 . More...
 
ta_e_result_code_t ta_terminal_add_listener (ta_object_t terminal, ta_object_t listener)
 Register listener. More...
 
ta_e_result_code_t ta_terminal_remove_listener (ta_object_t terminal, ta_object_t listener)
 Unregister listener. More...
 
ta_e_result_code_t ta_terminal_set_custom_logger (ta_object_t terminal, ta_cb_publish_log_record callback, void *user_pointer)
 Set custom terminal logger callback. More...
 

Function Documentation

◆ ta_terminal_activate()

ta_e_result_code_t ta_terminal_activate ( ta_object_t  terminal,
ta_object_t response 
)

Opens a user shift.

If the shift is already open, no error is returned.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is of type activate_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_activate_async()

ta_e_result_code_t ta_terminal_activate_async ( ta_object_t  terminal)

Opens a user shift.

If the shift is already open, no error is returned.

Asynchronous version of ta_terminal_activate. Callback function is ta_cb_terminal_activate_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest send successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_activate_service_menu()

ta_e_result_code_t ta_terminal_activate_service_menu ( ta_object_t  terminal)

Activate service menu.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_activate_service_menu_async()

ta_e_result_code_t ta_terminal_activate_service_menu_async ( ta_object_t  terminal)

Activate service menu.

Asynchronous version of ta_terminal_activate_service_menu. Callback function is ta_cb_terminal_activate_service_menu_completed.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_add_ecr_data()

ta_e_result_code_t ta_terminal_add_ecr_data ( ta_object_t  terminal,
ta_object_t  ecr_info 
)

Add ECR data replacing existing one if present.

To remove elements use ta_terminal_set_ecr_data instead.

Parameters
[in]terminalObject instance of type terminal.
[in]ecr_infoObject instance to add. Object instance has to be of type ecr_info.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentecr_info is ta_object_invalid.
ta_c_rc_invalid_argumentecr_info is not of type ecr_info.

◆ ta_terminal_add_listener()

ta_e_result_code_t ta_terminal_add_listener ( ta_object_t  terminal,
ta_object_t  listener 
)

Register listener.

Parameters
[in]terminalObject instance of type terminal.
[in]listenerObject instance of type terminal_listener.
Return values
ta_c_rc_okListener added to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentlistener is ta_object_invalid.

◆ ta_terminal_age_check()

ta_e_result_code_t ta_terminal_age_check ( ta_object_t  terminal,
ta_object_t  age_to_check,
ta_object_t response 
)

This function is used to start an age check on the terminal.

Note
This method is only available if guide value added services is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]age_to_checkObject of type integer with the age to check.
[out]responseVariable to write object of type transaction information. Object is retained.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentage_to_check is ta_object_invalid.
ta_c_rc_invalid_argumentage_to_check is not of type transaction information.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_age_check_async()

ta_e_result_code_t ta_terminal_age_check_async ( ta_object_t  terminal,
ta_object_t  age_to_check 
)

This function is used to start an age check on the terminal.

Asynchronous version of ta_terminal_age_check. Callback function is ta_cb_terminal_age_check_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]age_to_checkObject of type integer with the age to check.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentage_to_check is ta_object_invalid.
ta_c_rc_invalid_argumentage_to_check is not of type transaction information.

◆ ta_terminal_amt_adjustment()

ta_e_result_code_t ta_terminal_amt_adjustment ( ta_object_t  terminal,
ta_object_t  amount 
)

Dynamically adjusts the transaction amount of an already running transaction.

This is a "best effort" function and will be processed as long as the underlaying payment protocol supports it. The amount transmitted in the notification is the new total amount. The EFT does not calculate amounts, this is the ECRs responsibility.

To be able to validate if this notification has been processed correctly the TerminalStatus-notification must return the current adjusted Amount.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]amountObject instance of type amount.
Return values
ta_c_rc_okHold commit send to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is ta_object_invalid.
ta_c_rc_invalid_argumentamount is not of type amount.

◆ ta_terminal_amt_adjustment_2()

ta_e_result_code_t ta_terminal_amt_adjustment_2 ( ta_object_t  terminal,
ta_object_t  amount,
ta_object_t  amount_discount,
ta_object_t  loyalty_coupon_list,
ta_object_t  loyalty_information_list 
)

Dynamically adjusts the transaction amount of an already running transaction.

This is a "best effort" function and will be processed as long as the underlaying payment protocol supports it. The amount transmitted in the notification is the new total amount. The EFT does not calculate amounts, this is the ECRs responsibility.

To be able to validate if this notification has been processed correctly the TerminalStatus-notification must return the current adjusted Amount.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]amountObject instance of type amount.
[in]amount_discountOptional discount amount. If not ta_object_invalid object instance has to be of type amount_discount.
[in]loyalty_coupon_listOptional list of loyalty coupons. If not ta_object_invalid object instance has to be of type list with elements inside have to be of type loyalty_coupon.
[in]loyalty_information_listOptional list of loyalty information. If not ta_object_invalid object instance has to be of type list with elements inside have to be of type loyalty_information.
Return values
ta_c_rc_okHold commit send to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is ta_object_invalid.
ta_c_rc_invalid_argumentamount is not of type amount.
ta_c_rc_invalid_argumentamount_discount is not ta_object_invalid and is not of type amount_discount.
ta_c_rc_invalid_argumentloyalty_coupon_list is not ta_object_invalid and not of type list.
ta_c_rc_invalid_argumentElements in loyalty_coupon_list are ta_object_invalid.
ta_c_rc_invalid_argumentElements in loyalty_coupon_list are not of type loyalty_coupon.
ta_c_rc_invalid_argumentloyalty_information_list is not ta_object_invalid and not of type list.
ta_c_rc_invalid_argumentElements in loyalty_information_list are ta_object_invalid.
ta_c_rc_invalid_argumentElements in loyalty_information_list are not of type loyalty_information.

◆ ta_terminal_application_information()

ta_e_result_code_t ta_terminal_application_information ( ta_object_t  terminal)

Requests the list of brands available on the terminal.

Side-Effect:
Updates Brands member with all brands available on the terminal. Use ta_terminal_get_brands to retrieve them.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_application_information_async()

ta_e_result_code_t ta_terminal_application_information_async ( ta_object_t  terminal)

Requests the list of brands available on the terminal.

Asynchronous version of ta_terminal_application_information. Callback function is ta_cb_terminal_application_information_completed.

Side-Effect:
Updates Brands member with all brands available on the terminal. Use ta_terminal_get_brands to retrieve them.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest send successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_balance()

ta_e_result_code_t ta_terminal_balance ( ta_object_t  terminal,
ta_object_t response 
)

Forces the EFT Terminal to transmit all transactions to the host system as well to do the daily closing.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is of type balance_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_balance_async()

ta_e_result_code_t ta_terminal_balance_async ( ta_object_t  terminal)

Forces the EFT Terminal to transmit all transactions to the host system as well to do the daily closing.

Asynchronous version of ta_terminal_balance. Callback function is ta_cb_terminal_balance_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest send successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_balance_inquiry()

ta_e_result_code_t ta_terminal_balance_inquiry ( ta_object_t  terminal,
ta_object_t response 
)

Get information about the current account balance of the inserted card.

Note
This method is only available if guide advanced_retail is enabled.
Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is of type balance_inquiry_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_balance_inquiry_async()

ta_e_result_code_t ta_terminal_balance_inquiry_async ( ta_object_t  terminal)

Get information about the current account balance of the inserted card.

Asynchronous version of ta_terminal_balance_inquiry. Callback function is ta_cb_terminal_balance_inquiry_completed.

Note
This method is only available if guide advanced_retail is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_can_dcc()

ta_e_result_code_t ta_terminal_can_dcc ( ta_object_t  terminal,
ta_e_boolean_t result 
)

Returns true if at least one payment protocol and the terminal configuration offer DCC i.e. if there is a chance to do a DCC transaction.

Parameters
[in]terminalObject instance of type terminal.
[out]resultPointer to variable to write result to.
Return values
ta_c_rc_okResult written to result.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresult is null-pointer.

◆ ta_terminal_can_declined_receipts()

ta_e_result_code_t ta_terminal_can_declined_receipts ( ta_object_t  terminal,
ta_e_boolean_t result 
)

Support for "Declined Receipts" in at least one payment protocol.

Parameters
[in]terminalObject instance of type terminal.
[out]resultPointer to variable to write result to.
Return values
ta_c_rc_okResult written to result.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresult is null-pointer.

◆ ta_terminal_can_multi_account_selection()

ta_e_result_code_t ta_terminal_can_multi_account_selection ( ta_object_t  terminal,
ta_e_boolean_t result 
)

Support for multiple account selection.

Parameters
[in]terminalObject instance of type terminal.
[out]resultPointer to variable to write result to.
Return values
ta_c_rc_okResult written to result.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresult is null-pointer.

◆ ta_terminal_cancel()

ta_e_result_code_t ta_terminal_cancel ( ta_object_t  terminal)

Aborts an open asynchronous Financial Transaction or Non-Financial Transaction request, except for a ta_terminal_commit or ta_terminal_rollback_async request, which cannot be cancelled.

Further information: A Cancel-request is a best effort request. The EFT Terminal can ignore the Cancel-request if the request in progress is in a state it can not be cancelled. A Cancel-request has no effect if there's no open request of a Financial Transaction or Non-financial Transaction. If the EFT Terminal cancels the request in progress an error response is send back for the cancelled request (see chapter Abort Purchase for an example). Cancel-requests can be send multiple times in an attempt to cancel a request in progress but should be spaced by a few seconds. Cancel-requests themselves are never acknowledged by the EFT Terminal.

The Transaction request can only be cancelled before a Commit has been performed. Also the underlying payment protocol can restrict this functionality.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okCancel send to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_cancel2()

ta_e_result_code_t ta_terminal_cancel2 ( ta_object_t  terminal,
ta_e_boolean_t  silent,
ta_e_boolean_t  retain_card 
)

Aborts an open asynchronous Financial Transaction or Non-Financial Transaction request, except for a ta_terminal_commit or ta_terminal_rollback_async request, which cannot be cancelled.

Further information: A Cancel-request is a best effort request. The EFT Terminal can ignore the Cancel-request if the request in progress is in a state it can not be cancelled. A Cancel-request has no effect if there's no open request of a Financial Transaction or Non-financial Transaction. If the EFT Terminal cancels the request in progress an error response is send back for the cancelled request (see chapter Abort Purchase for an example). Cancel-requests can be send multiple times in an attempt to cancel a request in progress but should be spaced by a few seconds. Cancel-requests themselves are never acknowledged by the EFT Terminal.

The Transaction request can only be cancelled before a Commit has been performed. Also the underlying payment protocol can restrict this functionality.

Parameters
[in]terminalObject instance of type terminal.
[in]silentta_c_b_true to not show an abort screen otherwise ta_c_b_false.
[in]retain_cardta_c_b_true to not eject card otherwise ta_c_b_false.
Return values
ta_c_rc_okCancel send to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_change_language_for_request()

ta_e_result_code_t ta_terminal_change_language_for_request ( ta_object_t  terminal,
ta_object_t  language 
)

The ChangeLanguage-notification changes the current cardholder language of the EFT.

It is intended as a way of changing the cardholder language during transactions or dialog interactions, e.g. if a cardholder uses a language selection mechanism of a unattended device.

This is a best effort function.

Parameters
[in]terminalObject instance of type terminal.
[in]languageObject instance of type string. Language string is either two or five letter long. Two-Letter Format: The two letters are a ISO-639-1 language code. E.g. da, nl, ... Five-Letter Format: The five letters are a combination of a two letter language code, a dash, and a two letter uppercase country code as recommended by RFC 5646. E.g. de-CH, fr-BE.
Return values
ta_c_rc_okHold commit send to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentlanguage is ta_object_invalid.
ta_c_rc_invalid_argumentlanguage is not of type string.

◆ ta_terminal_change_settings()

ta_e_result_code_t ta_terminal_change_settings ( ta_object_t  terminal,
ta_object_t  settings 
)

Changes configuration parameters of the EFT Terminal.

Parameters
[in]terminalObject instance of type terminal.
[in]settingsObject instance with settings. Object instance has to be of type map. Keys in the map have to be of type integer matching ta_e_setting_type_t. Values in the map have to be of type string.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentsettings is ta_object_invalid.
ta_c_rc_invalid_argumentsettings is not of type map.
ta_c_rc_invalid_argumentKey in settings is ta_object_invalid.
ta_c_rc_invalid_argumentKey in settings is not of type integer.
ta_c_rc_invalid_argumentValue in settings is ta_object_invalid.
ta_c_rc_invalid_argumentValue in settings is not of type string.

◆ ta_terminal_change_settings_async()

ta_e_result_code_t ta_terminal_change_settings_async ( ta_object_t  terminal,
ta_object_t  settings 
)

Changes configuration parameters of the EFT Terminal.

Asynchronous version of ta_terminal_change_settings. Callback function is ta_cb_terminal_change_settings_completed.

Parameters
[in]terminalObject instance of type terminal.
[in]settingsObject instance with settings. Object instance has to be of type map. Keys in the map have to be of type integer matching ta_e_setting_type_t. Values in the map have to be of type string.
Return values
ta_c_rc_okRequest send successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentsettings is ta_object_invalid.
ta_c_rc_invalid_argumentsettings is not of type map.
ta_c_rc_invalid_argumentKey in settings is ta_object_invalid.
ta_c_rc_invalid_argumentKey in settings is not of type integer.
ta_c_rc_invalid_argumentValue in settings is ta_object_invalid.
ta_c_rc_invalid_argumentValue in settings is not of type string.

◆ ta_terminal_client_identification()

ta_e_result_code_t ta_terminal_client_identification ( ta_object_t  terminal,
ta_object_t response 
)

Starts an EFT Client Identification.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is ta_object_invalid if not contained in the response. Otherwise object instance is of type client_identification_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. If object instance is not ta_object_invalid object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_client_identification_async()

ta_e_result_code_t ta_terminal_client_identification_async ( ta_object_t  terminal)

Starts an EFT Client Identification.

Asynchronous version of ta_terminal_client_identification. Callback function is ta_cb_terminal_client_identification_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_close_dialog_mode()

ta_e_result_code_t ta_terminal_close_dialog_mode ( ta_object_t  terminal)

Close dialog mode on the terminal.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_close_dialog_mode_async()

ta_e_result_code_t ta_terminal_close_dialog_mode_async ( ta_object_t  terminal)

Close dialog mode on the terminal.

Asynchronous version of ta_terminal_close_dialog_mode. Callback function is ta_cb_terminal_close_dialog_mode_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_close_maintenance_window()

ta_e_result_code_t ta_terminal_close_maintenance_window ( ta_object_t  terminal)

Closes the maintenance window to the terminal so it can perform collected maintenance requests on its own, without interaction with the ECR.

The terminal shall respond immediately to the ECR request whether it is able to handle the request or not.

If the terminal is able to handle the request, the ECR is free itself to perform maintenance as well or it can monitor the terminal by reading the terminal_status notifications.

It is possible that the connection between ECR and EFT terminal is terminated due to one or multiple reboot processes.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_close_maintenance_window_async()

ta_e_result_code_t ta_terminal_close_maintenance_window_async ( ta_object_t  terminal)

Closes the maintenance window to the terminal so it can perform collected maintenance requests on its own, without interaction with the ECR.

The terminal shall respond immediately to the ECR request whether it is able to handle the request or not.

If the terminal is able to handle the request, the ECR is free itself to perform maintenance as well or it can monitor the terminal by reading the terminal_status notifications.

It is possible that the connection between ECR and EFT terminal is terminated due to one or multiple reboot processes.

Asynchronous version of ta_terminal_close_maintenance_window. Callback function is ta_cb_terminal_close_maintenance_window_completed.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_close_reader()

ta_e_result_code_t ta_terminal_close_reader ( ta_object_t  terminal)

Close the shutter of the card reader.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_close_reader_async()

ta_e_result_code_t ta_terminal_close_reader_async ( ta_object_t  terminal)

Close the shutter of the card reader.

Asynchronous version of ta_terminal_close_reader. Callback function is ta_cb_terminal_close_reader_completed.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_commit()

ta_e_result_code_t ta_terminal_commit ( ta_object_t  terminal)

Performs Commit-operation after a successful Transaction call.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_commit_amount()

ta_e_result_code_t ta_terminal_commit_amount ( ta_object_t  terminal,
ta_object_t  amount,
ta_object_t response 
)

Performs Commit-operation after a successful Transaction call.

Parameters
[in]terminalObject instance of type terminal.
[in]amountObject instance of type amount or ta_object_invalid.
[out]responsePointer to write object instance of type print_data.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is not ta_object_invalid and object instance is not of type amount.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_commit_amount_async()

ta_e_result_code_t ta_terminal_commit_amount_async ( ta_object_t  terminal,
ta_object_t  amount 
)

Performs Commit-operation after a successful Transaction call.

Asynchronous version of ta_terminal_commit. Callback function is ta_cb_terminal_commit_completed.

Parameters
[in]terminalObject instance of type terminal.
[in]amountObject instance of type amount or ta_object_invalid.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is not ta_object_invalid and object instance is not of type amount.

◆ ta_terminal_commit_async()

ta_e_result_code_t ta_terminal_commit_async ( ta_object_t  terminal)

Performs Commit-operation after a successful Transaction call.

Asynchronous version of ta_terminal_commit. Callback function is ta_cb_terminal_commit_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_connect()

ta_e_result_code_t ta_terminal_connect ( ta_object_t  terminal)

Initiates a connection to the EFT Terminal.

Calling this function is not needed normally, because all methods make first a connect, if not connected

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okConnected to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_connect_async()

ta_e_result_code_t ta_terminal_connect_async ( ta_object_t  terminal)

Initiates a connection to the EFT Terminal.

Calling this function is not needed normally, because all methods make first a connect, if not connected

Asynchronous version of ta_terminal_connect. Callback function is ta_cb_terminal_connect_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okStarted connecting to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_convert_six_trans_ref_to_legacy()

ta_e_result_code_t ta_terminal_convert_six_trans_ref_to_legacy ( ta_object_t  six_trans_ref,
ta_object_t result 
)

This function tries to convert a SIXTransRef of type X:Y:4 into A SIXTransRef of type X:Y:1 .

For all other SIXTransRef values the value will be returned unchanged.

Parameters
[in]six_trans_refSIX Transaction Reference to convert.
[out]resultPointer to variable to write result to. Result is of type string.
Return values
ta_c_rc_okResult written to result.
ta_c_rc_invalid_argumentsix_trans_ref is ta_object_invalid.
ta_c_rc_invalid_argumentresult is null-pointer.

◆ ta_terminal_counter_request()

ta_e_result_code_t ta_terminal_counter_request ( ta_object_t  terminal,
ta_e_counter_type_t  counter_type,
ta_object_t response 
)

Get counter information's from the EFT Terminal.

Parameters
[in]terminalObject instance of type terminal.
[in]counter_typeType of counters to receive.
[out]responsePointer to variable to write object instance to. Object instance is of type counters. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_counter_request_async()

ta_e_result_code_t ta_terminal_counter_request_async ( ta_object_t  terminal,
ta_e_counter_type_t  counter_type 
)

Get counter information's from the EFT Terminal.

Asynchronous version of ta_terminal_counter_request. Callback function is ta_cb_terminal_counter_request_completed.

Parameters
[in]terminalObject instance of type terminal.
[in]counter_typeType of counters to receive.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_create()

ta_e_result_code_t ta_terminal_create ( ta_object_t terminal,
ta_object_t  settings 
)

Create terminal instance.

Caller retains a reference to the created instance. Different users can individually retain the terminal instance themselves by calling ta_object_retain. Each call to ta_object_retain and ta_terminal_create has to be matched with a call to ta_object_release. The terminal instance is destroyed once nobody retains the terminal instance anymore.

The provided terminal settings instance is not change nor stored. Instead an immutable copy thereof is stored.

Parameters
[out]terminalPointer to variable to write created object instance to. Created object instance is retained.
[in]settingsObject instance of type terminal_settings. Terminal object stores an internal read-only copy of the terminal settings. It is safe to change the object instance after this call without affecting the terminal object.
Return values
ta_c_rc_okObject instance has been created and written to terminal.
ta_c_rc_invalid_argumentterminal is null-pointer.
ta_c_rc_invalid_argumentsettings is ta_object_invalid.
ta_c_rc_out_of_memoryFailed allocating memory.

◆ ta_terminal_dcc_rates()

ta_e_result_code_t ta_terminal_dcc_rates ( ta_object_t  terminal,
ta_object_t response 
)

Requests DCC rates from the EFT Terminal.

The DCC rates are returned as receipt.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is of type print_data. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_dcc_rates_async()

ta_e_result_code_t ta_terminal_dcc_rates_async ( ta_object_t  terminal)

Requests DCC rates from the EFT Terminal.

The DCC rates are returned as receipt.

Asynchronous version of ta_terminal_dcc_rates. Callback function is ta_cb_terminal_dcc_rates_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_deactivate()

ta_e_result_code_t ta_terminal_deactivate ( ta_object_t  terminal,
ta_object_t response 
)

Closes a user shift.

If the shift is already closed, no error is returned.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is of type deactivate_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_deactivate_async()

ta_e_result_code_t ta_terminal_deactivate_async ( ta_object_t  terminal)

Closes a user shift.

If the shift is already closed, no error is returned.

Asynchronous version of ta_terminal_deactivate. Callback function is ta_cb_terminal_deactivate_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_device_maintenance()

ta_e_result_code_t ta_terminal_device_maintenance ( ta_object_t  terminal,
ta_e_maintenance_type_t  type 
)

Perform device maintenance.

Parameters
[in]terminalObject instance of type terminal.
[in]typeType of maintenance to perform.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_device_maintenance_async()

ta_e_result_code_t ta_terminal_device_maintenance_async ( ta_object_t  terminal,
ta_e_maintenance_type_t  type 
)

Perform device maintenance.

Asynchronous version of ta_terminal_device_maintenance. Callback function is ta_cb_terminal_device_maintenance_completed.

Parameters
[in]terminalObject instance of type terminal.
[in]typeType of maintenance to perform.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_disconnect()

ta_e_result_code_t ta_terminal_disconnect ( ta_object_t  terminal)

Interrupts the connection to the EFT Terminal.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okDisconnected from terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_disconnect_async()

ta_e_result_code_t ta_terminal_disconnect_async ( ta_object_t  terminal)

Interrupts the connection to the EFT Terminal.

Asynchronous version of ta_terminal_disconnect. Callback function is ta_cb_terminal_disconnected.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okStarted disconnecting from terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_dispose()

ta_e_result_code_t ta_terminal_dispose ( ta_object_t  terminal)

Dispose of terminal.

Once disposed all terminal functionality returns ta_c_rc_invalid_argument if called.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okTerminal has been disposed.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_eject_card()

ta_e_result_code_t ta_terminal_eject_card ( ta_object_t  terminal)

Eject a card from the card reader.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_eject_card_async()

ta_e_result_code_t ta_terminal_eject_card_async ( ta_object_t  terminal)

Eject a card from the card reader.

Asynchronous version of ta_terminal_eject_card. Callback function is ta_cb_terminal_eject_card_completed.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_finish_checkout()

ta_e_result_code_t ta_terminal_finish_checkout ( ta_object_t  terminal,
ta_object_t response 
)

This function is used to finish a previously started checkout process with StartCheckout and to retrieve consumer loyalty data from the terminal that has been collected during this checkout process.

Note
This method is only available if guide value added services is enabled.
Parameters
[in]terminalObject instance of type terminal.
[out]responseVariable to write object of type vas_checkout_information.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_finish_checkout_async()

ta_e_result_code_t ta_terminal_finish_checkout_async ( ta_object_t  terminal)

This function is used to finish a previously started checkout process with StartCheckout and to retrieve consumer loyalty data from the terminal that has been collected during this checkout process.

Asynchronous version of ta_terminal_finish_checkout. Callback function is ta_cb_terminal_finish_checkout_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_get_act_seq_counter()

ta_e_result_code_t ta_terminal_get_act_seq_counter ( ta_object_t  terminal,
int *  act_seq_counter 
)

Activation sequence counter.

Parameters
[in]terminalObject instance of type terminal.
[out]act_seq_counterPointer to variable to write value to.
Return values
ta_c_rc_okValue written to act_seq_counter.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentact_seq_counter is null-pointer.

◆ ta_terminal_get_allowed_third_party_apps()

ta_e_result_code_t ta_terminal_get_allowed_third_party_apps ( ta_object_t  terminal,
int *  allowed_third_party_apps 
)

Allowed third party apps.

Parameters
[in]terminalObject instance of type terminal.
[out]allowed_third_party_appsOR combined flags from ta_e_allowed_third_party_apps_t.
Return values
ta_c_rc_okObject instance written to allowed_third_party_apps. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentallowed_third_party_apps is null-pointer.

◆ ta_terminal_get_brands()

ta_e_result_code_t ta_terminal_get_brands ( ta_object_t  terminal,
ta_object_t brands 
)

Get brands or 0 if not retrieved yet.

Parameters
[in]terminalObject instance of type terminal.
[out]brandsPointer to variable to write object instance to. Object instance is ta_object_invalid if not set in terminal. Otherwise object instance is of type list and object instance is retained. Elements in the list are of type brand.
Return values
ta_c_rc_okObject instance written to brands. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentbrands is null-pointer.

◆ ta_terminal_get_config_data()

ta_e_result_code_t ta_terminal_get_config_data ( ta_object_t  terminal,
ta_object_t config_data 
)

Get configuration data.

Parameters
[in]terminalObject instance of type terminal.
[out]config_dataPointer to variable to write object instance to. Object instance is ta_object_invalid if not set in terminal. Otherwise object instance is of type config_data and object instance is retained.
Return values
ta_c_rc_okObject instance written to config_data. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentconfig_data is null-pointer.

◆ ta_terminal_get_customer_data()

ta_e_result_code_t ta_terminal_get_customer_data ( ta_object_t  terminal,
ta_object_t customer_data 
)

Customer data.

Parameters
[in]terminalObject instance of type terminal.
[out]customer_dataPointer to variable to write object instance to. Object instance is of type map. Object instance is retained. Elements in the map are of key type integer containing values of enumeration ta_e_customer_data_type_t and value type string.
Return values
ta_c_rc_okObject instance written to customer_data. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentcustomer_data is null-pointer.

◆ ta_terminal_get_ecr_data()

ta_e_result_code_t ta_terminal_get_ecr_data ( ta_object_t  terminal,
ta_object_t ecr_data 
)

ECR Data.

Parameters
[in]terminalObject instance of type terminal.
[out]ecr_dataPointer to variable to write object instance to. Object instance is of type list. Object instance is retained. Elements in the list are of type ecr_info.
Return values
ta_c_rc_okObject instance written to ecr_data. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentecr_data is null-pointer.

◆ ta_terminal_get_features()

ta_e_result_code_t ta_terminal_get_features ( ta_object_t  terminal,
ta_s_features_t features,
ta_e_boolean_t has_features 
)

Get features if known.

Parameters
[in]terminalObject instance of type terminal.
[out]featuresPointer to variable to write values to if features are known. Pointer can be null-pointer if only feature presence is of interest.
[out]has_featuresPointer to variable to write presence of features. Set to ta_c_b_true if features are present otherwise ta_c_b_false.
Return values
ta_c_rc_okFeature presence written to has_features. If has_features is ta_c_b_true values are also written to features.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumenthas_features is null-pointer.

◆ ta_terminal_get_item_textcode()

ta_e_result_code_t ta_terminal_get_item_textcode ( ta_object_t  terminal,
int  item_text_code,
ta_e_additional_info_item_t result 
)

Convert item text code to AdditionalInfoItem value.

Parameters
[out]resultPointer to variable to write result to.
Return values
ta_c_rc_okResult written to result.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresult is null-pointer.

◆ ta_terminal_get_item_textcode_description()

ta_e_result_code_t ta_terminal_get_item_textcode_description ( ta_object_t  terminal,
ta_e_additional_info_item_t  item,
const char **  result 
)

Get text description of AdditionalInfoItem.

Parameters
[out]resultPointer to variable to write result to.
Return values
ta_c_rc_okResult written to result.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresult is null-pointer.

◆ ta_terminal_get_license()

ta_e_result_code_t ta_terminal_get_license ( ta_object_t  terminal,
ta_object_t license 
)

Supported licensed features as 8 bytes hex encoded bitmap.

Deprecated:
Functionality removed.
Parameters
[in]terminalObject instance of type terminal.
[out]licensePointer to variable to write object instance to. Object instance is ta_object_invalid if not set in terminal. Otherwise object instance is of type string and object instance is retained.
Return values
ta_c_rc_okObject instance written to license. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentlicense is null-pointer.

◆ ta_terminal_get_merchant_options()

ta_e_result_code_t ta_terminal_get_merchant_options ( ta_object_t  terminal,
ta_object_t merchant_options 
)

Merchant options.

Parameters
[in]terminalObject instance of type terminal.
[out]merchant_optionsPointer to variable to write object instance to. Object instance is of type list. Object instance is retained. Elements in the list are of type merchant_option.
Return values
ta_c_rc_okObject instance written to merchant_options. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentmerchant_options is null-pointer.

◆ ta_terminal_get_pos_id()

ta_e_result_code_t ta_terminal_get_pos_id ( ta_object_t  terminal,
ta_object_t pos_id 
)

POS identifier.

Parameters
[in]terminalObject instance of type terminal.
[out]pos_idPointer to variable to write object instance to. Object instance is of type string. Object instance is retained.
Return values
ta_c_rc_okObject instance written to pos_id. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentpos_id is null-pointer.

◆ ta_terminal_get_print_options()

ta_e_result_code_t ta_terminal_get_print_options ( ta_object_t  terminal,
ta_object_t print_options 
)

Print options.

Parameters
[in]terminalObject instance of type terminal.
[out]print_optionsPointer to variable to write object instance to. Object instance is of type list. Object instance is retained. Elements in the list are of type print_option.
Return values
ta_c_rc_okObject instance written to print_options. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentprint_options is null-pointer.

◆ ta_terminal_get_receipt_formatter()

ta_e_result_code_t ta_terminal_get_receipt_formatter ( ta_object_t  terminal,
ta_object_t formatter 
)

Receipt formatter.

Parameters
[in]terminalObject instance of type terminal.
[out]formatterPointer to variable to write object instance to. Object instance is ta_object_invalid if not set in terminal. If object instance is not ta_object_invalid it is of type receipt_formatter and will be retained.
Return values
ta_c_rc_okObject instance written to formatter. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentformatter is null-pointer.

◆ ta_terminal_get_settings()

ta_e_result_code_t ta_terminal_get_settings ( ta_object_t  terminal,
ta_object_t settings 
)

Immutable terminal settings.

Parameters
[in]terminalObject instance of type terminal.
[out]settingsPointer to variable to write object instance to. Object instance is of type terminal_settings. Object instance is retained.
Return values
ta_c_rc_okObject instance written to settings. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentsettings is null-pointer.

◆ ta_terminal_get_supported_languages()

ta_e_result_code_t ta_terminal_get_supported_languages ( ta_object_t  terminal,
ta_object_t languages 
)

Get supported languages or ta_object_invalid if unknown.

Parameters
[in]terminalObject instance of type terminal.
[out]languagesPointer to variable to write object instance to. Object instance is ta_object_invalid if not set in terminal. Otherwise object instance is of type list and object instance is retained. Elements in the list are of type string.
Return values
ta_c_rc_okObject instance written to languages. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentlanguages is null-pointer.

◆ ta_terminal_get_terminal_id()

ta_e_result_code_t ta_terminal_get_terminal_id ( ta_object_t  terminal,
ta_object_t terminal_id 
)

Terminal identifier of connected terminal.

Returns ta_object_invalid if the terminal identifier is not known. The terminal identifier is available after logging in to the terminal. The terminal identifier obtained from the terminal is potentially different from the terminal identifier set in the terminal_settings. This is especially true if ta_c_cm_on_fix_ip is used.

Parameters
[in]terminalObject instance of type terminal.
[out]terminal_idPointer to variable to write object instance to. Object instance is of type string. Object instance is retained.
Return values
ta_c_rc_okObject instance written to settings. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentterminal_id is null-pointer.

◆ ta_terminal_get_terminal_status()

ta_e_result_code_t ta_terminal_get_terminal_status ( ta_object_t  terminal,
ta_object_t terminal_status 
)

Get terminal status.

Parameters
[in]terminalObject instance of type terminal.
[out]terminal_statusPointer to variable to write object instance to. Object instance is of type terminal_status. Object instance is retained.
Return values
ta_c_rc_okObject instance written to terminal_status. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentterminal_status is null-pointer.

◆ ta_terminal_get_transaction_data()

ta_e_result_code_t ta_terminal_get_transaction_data ( ta_object_t  terminal,
ta_object_t transaction_data 
)

Transaction data to use for transaction requests unless set manually.

Parameters
[in]terminalObject instance of type terminal.
[out]transaction_dataPointer to variable to write object instance to. Object instance is ta_object_invalid if not set in terminal. If object instance is not ta_object_invalid it is of type transaction_data and will be retained.
Return values
ta_c_rc_okObject instance written to transaction_data. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumenttransaction_data is null-pointer.

◆ ta_terminal_get_user_id()

ta_e_result_code_t ta_terminal_get_user_id ( ta_object_t  terminal,
int *  user_id 
)

User identifier.

Parameters
[in]terminalObject instance of type terminal.
[out]user_idPointer to variable to write value to.
Return values
ta_c_rc_okValue written to user_id.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentuser_id is null-pointer.

◆ ta_terminal_hardware_information()

ta_e_result_code_t ta_terminal_hardware_information ( ta_object_t  terminal,
ta_object_t response 
)

Get hardware information from the EFT Terminal.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is of type hardware_information_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_hardware_information_async()

ta_e_result_code_t ta_terminal_hardware_information_async ( ta_object_t  terminal)

Get hardware information from the EFT Terminal.

Asynchronous version of ta_terminal_hardware_information. Callback function is ta_cb_terminal_hardware_information_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_has_sw_update()

ta_e_result_code_t ta_terminal_has_sw_update ( ta_object_t  terminal,
ta_e_boolean_t result 
)

Software update is available.

Parameters
[in]terminalObject instance of type terminal.
[out]resultPointer to variable to write result to.
Return values
ta_c_rc_okResult written to result.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresult is null-pointer.

◆ ta_terminal_hold_commit()

ta_e_result_code_t ta_terminal_hold_commit ( ta_object_t  terminal)

Extends the Commit timeout if the terminal needs additional time before the Commit shall be performed.

An example could be on a public transport vending machine: if the machine is printing multiple tickets and this printing action would extend the commit timeout, a hold_commit notification shall be sent to extend the Commit timeout as well. If the printing action fails after some tickets a partial commit can be performed.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okHold commit send to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_init_transaction()

ta_e_result_code_t ta_terminal_init_transaction ( ta_object_t  terminal,
ta_e_boolean_t  display_amount,
ta_object_t  amount,
ta_object_t response 
)

Initialize a transaction knowing the amount or the card type.

Parameters
[in]terminalObject instance of type terminal.
[in]display_amountta_c_b_true to display amount on screen. ta_c_b_false to not display amount on screen. ta_c_b_undefined to use default behavior of terminal.
[in]amountObject instance of type amount. Can be ta_object_invalid to not use an amount. display_amount has no effect if not amount is used.
[out]responsePointer to variable to write object instance to. Object instance is ta_object_invalid if not contained in the response. Otherwise object instance is of type card_data. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. If object instance is not ta_object_invalid object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is not ta_object_invalid and is not of type amount.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_init_transaction2()

ta_e_result_code_t ta_terminal_init_transaction2 ( ta_object_t  terminal,
ta_e_boolean_t  display_amount,
ta_object_t  amount,
ta_e_function_hint_t  function_hint,
ta_object_t response 
)

Initialize a transaction knowing the amount or the card type.

Parameters
[in]terminalObject instance of type terminal.
[in]display_amountta_c_b_true to display amount on screen. ta_c_b_false to not display amount on screen. ta_c_b_undefined to use default behavior of terminal.
[in]amountObject instance of type amount. Can be ta_object_invalid to not use an amount. display_amount has no effect if not amount is used.
[in]function_hintFunction hint.
[out]responsePointer to variable to write object instance to. Object instance is ta_object_invalid if not contained in the response. Otherwise object instance is of type card_data. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. If object instance is not ta_object_invalid object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is not ta_object_invalid and is not of type amount.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_init_transaction2_async()

ta_e_result_code_t ta_terminal_init_transaction2_async ( ta_object_t  terminal,
ta_e_boolean_t  display_amount,
ta_object_t  amount,
ta_e_function_hint_t  function_hint 
)

Initialize a transaction knowing the amount or the card type.

Asynchronous version of ta_terminal_init_transaction. Callback function is ta_cb_terminal_init_transaction_completed.

Parameters
[in]terminalObject instance of type terminal.
[in]display_amountta_c_b_true to display amount on screen. ta_c_b_false to not display amount on screen. ta_c_b_undefined to use default behavior of terminal.
[in]amountObject instance of type amount. Can be ta_object_invalid to not use an amount. display_amount has no effect if not amount is used.
[in]function_hintFunction hint.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is not ta_object_invalid and is not of type amount.

◆ ta_terminal_init_transaction_async()

ta_e_result_code_t ta_terminal_init_transaction_async ( ta_object_t  terminal,
ta_e_boolean_t  display_amount,
ta_object_t  amount 
)

Initialize a transaction knowing the amount or the card type.

Asynchronous version of ta_terminal_init_transaction. Callback function is ta_cb_terminal_init_transaction_completed.

Parameters
[in]terminalObject instance of type terminal.
[in]display_amountta_c_b_true to display amount on screen. ta_c_b_false to not display amount on screen. ta_c_b_undefined to use default behavior of terminal.
[in]amountObject instance of type amount. Can be ta_object_invalid to not use an amount. display_amount has no effect if not amount is used.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is not ta_object_invalid and is not of type amount.

◆ ta_terminal_init_transaction_with_dialog()

ta_e_result_code_t ta_terminal_init_transaction_with_dialog ( ta_object_t  terminal,
ta_object_t  amount,
ta_e_function_hint_t  function_hint,
ta_object_t  dialog,
ta_object_t response 
)

Initialize a transaction with dialog.

Parameters
[in]terminalObject instance of type terminal.
[in]amountObject instance of type amount.
[in]function_hintFunction hint.
[in]dialogObject instance of type show_dialog_request.
[out]responsePointer to variable to write object instance to. Object instance is ta_object_invalid if not contained in the response. Otherwise object instance is of type init_transaction_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. If object instance is not ta_object_invalid object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is not ta_object_invalid and is not of type amount.
ta_c_rc_invalid_argumentdialog is not ta_object_invalid and is not of type show_dialog_request.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_init_transaction_with_dialog_async()

ta_e_result_code_t ta_terminal_init_transaction_with_dialog_async ( ta_object_t  terminal,
ta_object_t  amount,
ta_e_function_hint_t  function_hint,
ta_object_t  dialog 
)

Initialize a transaction with dialog.

Asynchronous version of ta_terminal_init_transaction_with_dialog. Callback function is ta_cb_terminal_init_transaction_with_dialog_completed.

Parameters
[in]terminalObject instance of type terminal.
[in]amountObject instance of type amount.
[in]function_hintFunction hint.
[in]dialogObject instance of type show_dialog_request.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is not ta_object_invalid and is not of type amount.
ta_c_rc_invalid_argumentdialog is not ta_object_invalid and is not of type show_dialog_request.

◆ ta_terminal_login()

ta_e_result_code_t ta_terminal_login ( ta_object_t  terminal)

Activate a communication session between the ECR and the terminal.

Note
Before calling set the print options, POS identifier and manufacturer flags set in the terminal instance.
Side-Effect:

After completing the request updates the features, brands and terminal identifier in the terminal instance. Fetching these information can be disabled if Auto-FetchBrands is disabled terminal_settings

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_login_async()

ta_e_result_code_t ta_terminal_login_async ( ta_object_t  terminal)

Activate a communication session between the ECR and the terminal.

Asynchronous version of ta_terminal_login. Callback function is ta_cb_terminal_login_completed.

Note
Before calling set the print options, POS identifier and manufacturer flags set in the terminal instance.
Side-Effect:

After completing the request updates the features, brands and terminal identifier in the terminal instance. Fetching these information can be disabled if Auto-FetchBrands is disabled terminal_settings

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_logout()

ta_e_result_code_t ta_terminal_logout ( ta_object_t  terminal)

Terminates an active communication session between the ECR and the terminal.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_logout_async()

ta_e_result_code_t ta_terminal_logout_async ( ta_object_t  terminal)

Terminates an active communication session between the ECR and the terminal.

Asynchronous version of ta_terminal_logout. Callback function is ta_cb_terminal_logout_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_loyalty_data()

ta_e_result_code_t ta_terminal_loyalty_data ( ta_object_t  terminal,
ta_e_loyalty_function_type_t  function_type,
ta_object_t  data_type,
ta_object_t  data,
ta_e_boolean_t  retain_card,
ta_object_t response 
)

This function is used to query and configure loyalty information.

Note
This method is only available if guide value added services is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]function_typeDefines what kind of loyalty mode will be used.
[in]data_typeSpecifies type of loyalty data. Mandatory for function_type ta_c_lft_init, ta_c_lft_update and ta_c_lft_deinit. If not ta_object_invalid has to be of type string.
[in]dataLoyalty data. Object of type string.
[in]retain_cardta_c_b_true to not eject card otherwise ta_c_b_false.
[out]responseVariable to write object of type card_data.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentfunction_type is not a valid value of ta_e_loyalty_function_type_t.
ta_c_rc_invalid_argumentdata_type is not ta_object_invalid and is not of type string.
ta_c_rc_invalid_argumentdata is ta_object_invalid.
ta_c_rc_invalid_argumentdata is not of type string.
ta_c_rc_invalid_argumentretain_card is ta_c_b_undefined.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_loyalty_data_async()

ta_e_result_code_t ta_terminal_loyalty_data_async ( ta_object_t  terminal,
ta_e_loyalty_function_type_t  function_type,
ta_object_t  data_type,
ta_object_t  data,
ta_e_boolean_t  retain_card 
)

This function is used to query and configure loyalty information.

Asynchronous version of ta_terminal_loyalty_data. Callback function is ta_cb_terminal_loyalty_data_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]function_typeDefines what kind of loyalty mode will be used.
[in]data_typeSpecifies type of loyalty data. Mandatory for function_type ta_c_lft_init, ta_c_lft_update and ta_c_lft_deinit. If not ta_object_invalid has to be of type string.
[in]dataLoyalty data. Object of type string.
[in]retain_cardta_c_b_true to not eject card otherwise ta_c_b_false.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentfunction_type is not a valid value of ta_e_loyalty_function_type_t.
ta_c_rc_invalid_argumentdata_type is not ta_object_invalid and is not of type string.
ta_c_rc_invalid_argumentdata is ta_object_invalid.
ta_c_rc_invalid_argumentdata is not of type string.
ta_c_rc_invalid_argumentretain_card is ta_c_b_undefined.

◆ ta_terminal_mobile_topup()

ta_e_result_code_t ta_terminal_mobile_topup ( ta_object_t  terminal,
ta_e_mobile_topup_type_t  type,
ta_object_t  issuer_name,
ta_object_t  amount,
ta_object_t response 
)

Mobile Topup transaction. Supported transaction type are PURCHASE and REVERSAL.

To use REVERSAL terminal has to be configured to support credit transactions.

Note
This method is only available if guide value added services is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]issuer_nameObject of type string.
[in]amountObject of type amount.
[out]responseVariable to write object of type mobile_topup_data.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresult is ta_object_invalid.
ta_c_rc_invalid_argumentresult is not of type mobile_topup_data.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_mobile_topup2()

ta_e_result_code_t ta_terminal_mobile_topup2 ( ta_object_t  terminal,
ta_e_mobile_topup_type_t  type,
ta_object_t  value,
ta_object_t response 
)

Mobile Topup transaction. Supported transaction type are PURCHASE and REVERSAL.

To use REVERSAL terminal has to be configured to support credit transactions.

Note
This method is only available if guide value added services is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]valueObject of type mobile_topup_value.
[out]responseVariable to write object of type mobile_topup_data.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresult is ta_object_invalid.
ta_c_rc_invalid_argumentresult is not of type mobile_topup_data.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_mobile_topup2_async()

ta_e_result_code_t ta_terminal_mobile_topup2_async ( ta_object_t  terminal,
ta_e_mobile_topup_type_t  type,
ta_object_t  value 
)

Mobile Topup transaction. Supported transaction type are PURCHASE and REVERSAL.

To use REVERSAL terminal has to be configured to support credit transactions.

Asynchronous version of ta_terminal_mobile_topup. Callback function is ta_cb_terminal_mobile_topup_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]valueObject of type mobile_topup_value.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_mobile_topup_async()

ta_e_result_code_t ta_terminal_mobile_topup_async ( ta_object_t  terminal,
ta_e_mobile_topup_type_t  type,
ta_object_t  issuer_name,
ta_object_t  amount 
)

Mobile Topup transaction. Supported transaction type are PURCHASE and REVERSAL.

To use REVERSAL terminal has to be configured to support credit transactions.

Asynchronous version of ta_terminal_mobile_topup. Callback function is ta_cb_terminal_mobile_topup_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]issuer_nameObject of type string.
[in]amountObject of type amount.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_mobile_topup_issuer_info()

ta_e_result_code_t ta_terminal_mobile_topup_issuer_info ( ta_object_t  terminal,
ta_object_t response 
)

Request Mobile Topup Issuer information.

Note
This method is only available if guide value added services is enabled.
Parameters
[in]terminalObject instance of type terminal.
[out]responseVariable to write object of type list with entries of type mobile_topup_value.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_mobile_topup_issuer_info_async()

ta_e_result_code_t ta_terminal_mobile_topup_issuer_info_async ( ta_object_t  terminal)

Request Mobile Topup Issuer information.

Asynchronous version of ta_terminal_mobile_topup_issuer_info. Callback function is ta_cb_terminal_mobile_topup_issuer_info_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_open_dialog_mode()

ta_e_result_code_t ta_terminal_open_dialog_mode ( ta_object_t  terminal)

Open dialog mode on the terminal.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_open_dialog_mode2()

ta_e_result_code_t ta_terminal_open_dialog_mode2 ( ta_object_t  terminal,
ta_e_boolean_t  silent 
)

Open dialog mode on the terminal.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]silentAfter opening the Dialog Mode the last screen content is retained until the the first ShowDialog is received
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_open_dialog_mode2_async()

ta_e_result_code_t ta_terminal_open_dialog_mode2_async ( ta_object_t  terminal,
ta_e_boolean_t  silent 
)

Open dialog mode on the terminal.

Asynchronous version of ta_terminal_open_dialog_mode. Callback function is ta_cb_terminal_open_dialog_mode_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]silentAfter opening the Dialog Mode the last screen content is retained until the the first ShowDialog is received
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_open_dialog_mode_async()

ta_e_result_code_t ta_terminal_open_dialog_mode_async ( ta_object_t  terminal)

Open dialog mode on the terminal.

Asynchronous version of ta_terminal_open_dialog_mode. Callback function is ta_cb_terminal_open_dialog_mode_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_open_maintenance_window()

ta_e_result_code_t ta_terminal_open_maintenance_window ( ta_object_t  terminal)

Opens the maintenance window to the terminal so it can perform collected maintenance requests on its own, without interaction with the ECR.

The terminal shall respond immediately to the ECR request whether it is able to handle the request or not.

If the terminal is able to handle the request, the ECR is free itself to perform maintenance as well or it can monitor the terminal by reading the terminal_status notifications.

It is possible that the connection between ECR and EFT terminal is terminated due to one or multiple reboot processes.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_open_maintenance_window_async()

ta_e_result_code_t ta_terminal_open_maintenance_window_async ( ta_object_t  terminal)

Opens the maintenance window to the terminal so it can perform collected maintenance requests on its own, without interaction with the ECR.

The terminal shall respond immediately to the ECR request whether it is able to handle the request or not.

If the terminal is able to handle the request, the ECR is free itself to perform maintenance as well or it can monitor the terminal by reading the terminal_status notifications.

It is possible that the connection between ECR and EFT terminal is terminated due to one or multiple reboot processes.

Asynchronous version of ta_terminal_open_maintenance_window. Callback function is ta_cb_terminal_open_maintenance_window_completed.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_open_reader()

ta_e_result_code_t ta_terminal_open_reader ( ta_object_t  terminal)

Open the shutter of the card reader.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_open_reader_async()

ta_e_result_code_t ta_terminal_open_reader_async ( ta_object_t  terminal)

Open the shutter of the card reader.

Asynchronous version of ta_terminal_open_reader. Callback function is ta_cb_terminal_open_reader_completed.

Note
This method is only available if guide unattended is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_print_on_terminal()

ta_e_result_code_t ta_terminal_print_on_terminal ( ta_object_t  terminal,
ta_object_t  ticket_data 
)

The PrintOnTerminal-function is used to send a freetext preformatted ticket from ECR to terminal.

The ticket is then printed on the terminal printer. The ticket must be formatted according [B39].

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]ticket_dataObject instance of type string.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentticket_data is ta_object_invalid.
ta_c_rc_invalid_argumentticket_data is not of type string.

◆ ta_terminal_print_on_terminal_async()

ta_e_result_code_t ta_terminal_print_on_terminal_async ( ta_object_t  terminal,
ta_object_t  ticket_data 
)

The PrintOnTerminal-function is used to send a freetext preformatted ticket from ECR to terminal.

The ticket is then printed on the terminal printer. The ticket must be formatted according [B39].

Asynchronous version of ta_terminal_print_on_terminal. Callback function is ta_cb_terminal_print_on_terminal_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]ticket_dataObject instance of type string.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentticket_data is ta_object_invalid.
ta_c_rc_invalid_argumentticket_data is not of type string.

◆ ta_terminal_provide_loyalty_basket()

ta_e_result_code_t ta_terminal_provide_loyalty_basket ( ta_object_t  terminal,
ta_object_t  basket,
ta_object_t response 
)

This function is used to provide the terminal with a LoyaltyBasket if the corresponding loyalty scheme requires it.

Note
This method is only available if guide value added services is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]basketObject of type list to send. Object contains elements of type loyalty_item.
[out]responseVariable to write object of type list. Object contains elements of type loyalty_item.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentbasket is ta_object_invalid.
ta_c_rc_invalid_argumentbasket is not of type list.
ta_c_rc_invalid_argumentElement in basket is ta_object_invalid.
ta_c_rc_invalid_argumentElement in basket is not of type loyalty_item.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_provide_loyalty_basket_async()

ta_e_result_code_t ta_terminal_provide_loyalty_basket_async ( ta_object_t  terminal,
ta_object_t  basket 
)

This function is used to provide the terminal with a LoyaltyBasket if the corresponding loyalty scheme requires it.

Asynchronous version of ta_terminal_provide_loyalty_basket. Callback function is ta_cb_terminal_provide_loyalty_basket_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]basketObject of type list to send. Object contains elements of type loyalty_item.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_provide_vas_result()

ta_e_result_code_t ta_terminal_provide_vas_result ( ta_object_t  terminal,
ta_object_t  result,
ta_object_t response 
)

This function is used to provide the terminal with a LoyaltyBasket if the corresponding loyalty scheme requires it.

Note
This method is only available if guide value added services is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]resultObject of type vas_result to send.
[out]responseVariable to write object of type vas_result.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresult is ta_object_invalid.
ta_c_rc_invalid_argumentresult is not of type vas_result.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_provide_vas_result_async()

ta_e_result_code_t ta_terminal_provide_vas_result_async ( ta_object_t  terminal,
ta_object_t  result 
)

This function is used to provide the terminal with a LoyaltyBasket if the corresponding loyalty scheme requires it.

Asynchronous version of ta_terminal_provide_vas_result. Callback function is ta_cb_terminal_provide_vas_result_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]resultObject of type vas_result to send.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_reboot()

ta_e_result_code_t ta_terminal_reboot ( ta_object_t  terminal)

Force the EFT Terminal to reboot.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_reboot_async()

ta_e_result_code_t ta_terminal_reboot_async ( ta_object_t  terminal)

Force the EFT Terminal to reboot.

Asynchronous version of ta_terminal_reboot. Callback function is ta_cb_terminal_reboot_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_receipt_request()

ta_e_result_code_t ta_terminal_receipt_request ( ta_object_t  terminal,
ta_e_receipt_request_type_t  type,
ta_object_t response 
)

Receive the latest receipt or a list of silent receipts.

Parameters
[in]terminalObject instance of type terminal.
[in]typeType of receipts to receive.
[out]responsePointer to variable to write object instance to. Object instance is of type receipt_request_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_receipt_request_async()

ta_e_result_code_t ta_terminal_receipt_request_async ( ta_object_t  terminal,
ta_e_receipt_request_type_t  type 
)

Receive the latest receipt or a list of silent receipts.

Asynchronous version of ta_terminal_receipt_request. Callback function is ta_cb_terminal_receipt_request_completed.

Parameters
[in]terminalObject instance of type terminal.
[in]typeType of receipts to receive.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_reconciliation()

ta_e_result_code_t ta_terminal_reconciliation ( ta_object_t  terminal,
ta_object_t response 
)

Force the EFT Terminal to transmit all financial transactions to the host system.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is of type reconciliation_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_reconciliation_async()

ta_e_result_code_t ta_terminal_reconciliation_async ( ta_object_t  terminal)

Force the EFT Terminal to transmit all financial transactions to the host system.

Asynchronous version of ta_terminal_reconciliation. Callback function is ta_cb_terminal_reconciliation_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_reconfig()

ta_e_result_code_t ta_terminal_reconfig ( ta_object_t  terminal,
ta_object_t response 
)

Force the EFT Terminal to get the configuration from the service center.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is ta_object_invalid if not contained in response. Otherwise object instance is of type print_data. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. If object instance is not ta_object_invalid object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_reconfig_async()

ta_e_result_code_t ta_terminal_reconfig_async ( ta_object_t  terminal)

Force the EFT Terminal to get the configuration from the service center.

Asynchronous version of ta_terminal_reconfig. Callback function is ta_cb_terminal_reconfig_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_remove_listener()

ta_e_result_code_t ta_terminal_remove_listener ( ta_object_t  terminal,
ta_object_t  listener 
)

Unregister listener.

Parameters
[in]terminalObject instance of type terminal.
[in]listenerObject instance of type terminal_listener.
Return values
ta_c_rc_okListener removed from terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentlistener is ta_object_invalid.

◆ ta_terminal_request_alias()

ta_e_result_code_t ta_terminal_request_alias ( ta_object_t  terminal,
ta_object_t  six_trans_ref,
ta_object_t response 
)

The RequestAlias-function is used to request a Saferpay Alias for Alias-based transactions.

Saferpay offers these kind of transactions which can be performed only using a secure Alias that can be created out of card information from a precious transaction. This Alias then can be used to perform a transaction without having the same card present.

An Alias can be used for the following transactions:

  • Purchase
  • Credit
  • Reservation
  • Recurring
Parameters
[in]terminalObject instance of type terminal.
[in]six_trans_refObject instance of type string.
[out]responsePointer to variable to write object instance to. Object instance is of type string. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentsix_trans_ref is ta_object_invalid.
ta_c_rc_invalid_argumentsix_trans_ref is not of type string.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_request_alias_async()

ta_e_result_code_t ta_terminal_request_alias_async ( ta_object_t  terminal,
ta_object_t  six_trans_ref 
)

The RequestAlias-function is used to request a Saferpay Alias for Alias-based transactions.

Saferpay offers these kind of transactions which can be performed only using a secure Alias that can be created out of card information from a precious transaction. This Alias then can be used to perform a transaction without having the same card present.

An Alias can be used for the following transactions:

  • Purchase
  • Credit
  • Reservation
  • Recurring

Asynchronous version of ta_terminal_request_alias. Callback function is ta_cb_terminal_request_alias_completed.

Parameters
[in]terminalObject instance of type terminal.
[in]six_trans_refObject instance of type string.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentsix_trans_ref is ta_object_invalid.
ta_c_rc_invalid_argumentsix_trans_ref is not of type string.

◆ ta_terminal_rollback()

ta_e_result_code_t ta_terminal_rollback ( ta_object_t  terminal,
ta_object_t response 
)

Prevents a transaction from being committed to the transaction log and generates a technical reversal of the authorization.

For payment protocols supporting the function a declined receipt may be generated.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is ta_object_invalid if not contained in response. Otherwise object instance is of type print_data. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_rollback_async()

ta_e_result_code_t ta_terminal_rollback_async ( ta_object_t  terminal)

Prevents a transaction from being committed to the transaction log and generates a technical reversal of the authorization.

For payment protocols supporting the function a declined receipt may be generated.

Asynchronous version of ta_terminal_rollback. Callback function is ta_cb_terminal_rollback_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_screenshot()

ta_e_result_code_t ta_terminal_screenshot ( ta_object_t  terminal)

Send notification to request EFT make a screenshot.

This is a "best effort" function.

Note
This method is only available if guide remote is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okHold commit send to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_send_card_command()

ta_e_result_code_t ta_terminal_send_card_command ( ta_object_t  terminal,
ta_object_t  requests,
ta_object_t responses 
)

Send card command.

This function is used for a direct communication with the inserted card using APDUs. It is possible to send a list of APDU command in the request (sixml:CommandRequestList) and to set responses that shall be accepted as "Positive" responses using sixml:PositiveAnswerList

Each sixml:CommandRequest is numbered with a unique order number (starting with 1). In the response, the terminal sends the response of the device for each CommandRequest, including the order number of the request.

If the device answers with a negative response (i.e. SW1SW2 != 9000 or other as "positive" defined answers using sixml:PositiveAnswerList), the processing of the sixml:CommandRequests is aborted, and the remaining commands are not sent to the device.

Furthermore it can be defined which dialogs shall be shown using the container sixml:CommandResources in the following use cases:

  • Dialog shown as preparation before sending an APDU command: sixml:PreResource
  • Dialog shown during APDU command execution: sixml:ExecutionResource
  • Dialog shown after receiving a positive response: sixml:PositiveResource
  • Dialog shown after receiving a negative response: sixml:NegativeResource
Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]requestsObject instance of type list. Elements in the list have to be of type command_request.
[out]responsesPointer to variable to write object instance to. Object instance is of type list. Object instance is retained. Elements in the list are of type command_response.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentrequests is ta_object_invalid.
ta_c_rc_invalid_argumentrequests is not of type list.
ta_c_rc_invalid_argumentElement in requests is ta_object_invalid.
ta_c_rc_invalid_argumentElement in requests is not of type command_request.
ta_c_rc_invalid_argumentresponses is null-pointer.

◆ ta_terminal_send_card_command_async()

ta_e_result_code_t ta_terminal_send_card_command_async ( ta_object_t  terminal,
ta_object_t  requests 
)

Send card command.

Asynchronous version of ta_terminal_send_card_command. Callback function is ta_cb_terminal_send_card_command_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]requestsObject instance of type list. Elements in the list have to be of type command_request.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentElement in requests is ta_object_invalid.
ta_c_rc_invalid_argumentElement in requests is not of type command_request.

◆ ta_terminal_set_allowed_third_party_apps()

ta_e_result_code_t ta_terminal_set_allowed_third_party_apps ( ta_object_t  terminal,
int  allowed_third_party_apps 
)

Set allowed third party apps.

Parameters
[in]terminalObject instance of type terminal.
[in]allowed_third_party_appsOR combined flags from ta_e_allowed_third_party_apps_t.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentallowed_third_party_apps is null-pointer.

◆ ta_terminal_set_custom_logger()

ta_e_result_code_t ta_terminal_set_custom_logger ( ta_object_t  terminal,
ta_cb_publish_log_record  callback,
void *  user_pointer 
)

Set custom terminal logger callback.

If not null-pointer the callback is used whenever the terminal logger needs to publish a new log record. The terminal logger is used whenever a terminal function is called, hence any function of ta_terminal_*. In all other cases the global logger is used. You can use the same logger for both global and terminal specific logging. If no custom terminal logger is set the global one is used if set.

Parameters
[in]terminalObject instance of type terminal.
[in]callbackCallback to set. Can be null-pointer to disable.
[in]user_pointerUser pointer to use in the callback.
Return values
ta_c_rc_okListener removed from terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.

◆ ta_terminal_set_customer_data()

ta_e_result_code_t ta_terminal_set_customer_data ( ta_object_t  terminal,
ta_object_t  customer_data 
)

Set Customer data.

Parameters
[in]terminalObject instance of type terminal.
[in]customer_dataObject instance to set. Object instance has to be of type map. Elements in the list have to be of key type integer with values from enumeration ta_e_customer_data_type_t and value type string.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentcustomer_data is ta_object_invalid.
ta_c_rc_invalid_argumentcustomer_data is not of type map.
ta_c_rc_invalid_argumentElement value in customer_data is ta_object_invalid.
ta_c_rc_invalid_argumentElement key in customer_data is not of type integer with values from enumeration ta_e_customer_data_type_t.
ta_c_rc_invalid_argumentElement value in customer_data is not of type string.

◆ ta_terminal_set_ecr_data()

ta_e_result_code_t ta_terminal_set_ecr_data ( ta_object_t  terminal,
ta_object_t  ecr_data 
)

Set ECR Data.

Parameters
[in]terminalObject instance of type terminal.
[in]ecr_dataObject instance to set. Object instance has to be of type list. Elements in the list have to be of type ecr_info.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentecr_data is ta_object_invalid.
ta_c_rc_invalid_argumentecr_data is not of type list.
ta_c_rc_invalid_argumentElement in ecr_data is ta_object_invalid.
ta_c_rc_invalid_argumentElement in ecr_data is not of type ecr_info.

◆ ta_terminal_set_merchant_options()

ta_e_result_code_t ta_terminal_set_merchant_options ( ta_object_t  terminal,
ta_object_t  merchant_options 
)

Set Merchant options.

Parameters
[in]terminalObject instance of type terminal.
[in]merchant_optionsObject instance to set. Object instance has to be of type list. Elements in the list have to be of type merchant_option.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentmerchant_options is ta_object_invalid.
ta_c_rc_invalid_argumentmerchant_options is not of type list.
ta_c_rc_invalid_argumentElement in merchant_options is ta_object_invalid.
ta_c_rc_invalid_argumentElement in merchant_options is not of type merchant_option.

◆ ta_terminal_set_pos_id()

ta_e_result_code_t ta_terminal_set_pos_id ( ta_object_t  terminal,
ta_object_t  pos_id 
)

Set POS identifier.

Parameters
[in]terminalObject instance of type terminal.
[in]pos_idObject instance to set. Object instance has to be of type string.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentpos_id is ta_object_invalid.
ta_c_rc_invalid_argumentpos_id is not of type string.

◆ ta_terminal_set_print_options()

ta_e_result_code_t ta_terminal_set_print_options ( ta_object_t  terminal,
ta_object_t  print_options 
)

Set Print options.

Parameters
[in]terminalObject instance of type terminal.
[in]print_optionsObject instance to set. Object instance has to be of type list. Elements in the list have to be of type print_option.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentprint_options is ta_object_invalid.
ta_c_rc_invalid_argumentprint_options is not of type list.
ta_c_rc_invalid_argumentElement in print_options is ta_object_invalid.
ta_c_rc_invalid_argumentElement in print_options is not of type print_option.

◆ ta_terminal_set_receipt_formatter()

ta_e_result_code_t ta_terminal_set_receipt_formatter ( ta_object_t  terminal,
ta_object_t  formatter 
)

Set receipt formatter.

Parameters
[in]terminalObject instance of type terminal.
[in]formatterObject instance to set. Object instance can be ta_object_invalid to clear the value in terminal. If object instance is not ta_object_invalid it has to be of type receipt_formatter.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentformatter is not ta_object_invalid and is not of type receipt_formatter.

◆ ta_terminal_set_transaction_data()

ta_e_result_code_t ta_terminal_set_transaction_data ( ta_object_t  terminal,
ta_object_t  transaction_data 
)

Set transaction data to use for transaction requests unless set manually.

Parameters
[in]terminalObject instance of type terminal.
[in]transaction_dataObject instance to set. Object instance can be ta_object_invalid to clear the value in terminal. If object instance is not ta_object_invalid it has to be of type transaction_data.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumenttransaction_data is not ta_object_invalid and is not of type transaction_data.

◆ ta_terminal_set_user_id()

ta_e_result_code_t ta_terminal_set_user_id ( ta_object_t  terminal,
int  user_id 
)

Set User identifier.

Parameters
[in]terminalObject instance of type terminal.
[in]user_idValue to set.
Return values
ta_c_rc_okObject instance assigned to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentuser_id is less than 0.

◆ ta_terminal_show_dialog()

ta_e_result_code_t ta_terminal_show_dialog ( ta_object_t  terminal,
ta_object_t  request,
ta_object_t response 
)

Show dialog on the terminal.

Can be called only if dialog mode is open.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]requestObject instance of type show_dialog_request.
[out]responsePointer to variable to write object instance to. Object instance is of type show_dialog_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentrequest is ta_object_invalid.
ta_c_rc_invalid_argumentrequest is not of type show_dialog_request.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_show_dialog_async()

ta_e_result_code_t ta_terminal_show_dialog_async ( ta_object_t  terminal,
ta_object_t  request 
)

Show dialog on the terminal.

Asynchronous version of ta_terminal_show_dialog. Callback function is ta_cb_terminal_show_dialog_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]requestObject instance of type show_dialog_request.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentrequest is ta_object_invalid.
ta_c_rc_invalid_argumentrequest is not of type show_dialog_request.

◆ ta_terminal_show_signature_capture()

ta_e_result_code_t ta_terminal_show_signature_capture ( ta_object_t  terminal,
ta_object_t  request,
ta_object_t response 
)

Show signature capture on the terminal.

Can be called only if dialog mode is open.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]requestObject instance of type show_signature_capture_request.
[out]responsePointer to variable to write object instance to. Object instance is of type show_signature_capture_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentrequest is ta_object_invalid.
ta_c_rc_invalid_argumentrequest is not of type show_signature_capture_request.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_show_signature_capture_async()

ta_e_result_code_t ta_terminal_show_signature_capture_async ( ta_object_t  terminal,
ta_object_t  request 
)

Request system information from the EFT Terminal.

Asynchronous version of ta_terminal_show_signature_capture. Callback function is ta_cb_terminal_show_signature_capture_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]requestObject instance of type show_signature_capture_request.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentrequest is ta_object_invalid.
ta_c_rc_invalid_argumentrequest is not of type show_signature_capture_request.

◆ ta_terminal_software_update()

ta_e_result_code_t ta_terminal_software_update ( ta_object_t  terminal,
ta_e_update_status_t response 
)

Force the EFT Terminal to start a Software Update.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write value to.
Return values
ta_c_rc_okRequest finished successfully. Value written to response.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_software_update_async()

ta_e_result_code_t ta_terminal_software_update_async ( ta_object_t  terminal)

Force the EFT Terminal to start a Software Update.

Asynchronous version of ta_terminal_software_update. Callback function is ta_cb_terminal_software_update_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_start_checkout()

ta_e_result_code_t ta_terminal_start_checkout ( ta_object_t  terminal)

This function is used to start a Checkout process at the POS to collect card and/or cardholder loyalty information before a transaction is started.

Therefore the Worldline QR code is displayed at the terminal. The timeout how long the QR code shall be displayed on the terminal before returning to its Idle screen can be defined in the Login request using the OptionType - QRCTimeout, see SIXml Book C: Appendix for further information.

Note
This method is only available if guide value added services is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest finished successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_start_checkout_async()

ta_e_result_code_t ta_terminal_start_checkout_async ( ta_object_t  terminal)

This function is used to start a Checkout process at the POS to collect card and/or cardholder loyalty information before a transaction is started.

Therefore the Worldline QR code is displayed at the terminal. The timeout how long the QR code shall be displayed on the terminal before returning to its Idle screen can be defined in the Login request using the OptionType - QRCTimeout, see SIXml Book C: Appendix for further information.

Asynchronous version of ta_terminal_start_checkout. Callback function is ta_cb_terminal_start_checkout_completed.

Note
This method is only available if guide dialog is enabled.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_system_information()

ta_e_result_code_t ta_terminal_system_information ( ta_object_t  terminal,
ta_object_t response 
)

Request system information from the EFT Terminal.

Note
Set EcrData property before calling SystemInformation.
Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is of type system_information_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_system_information_async()

ta_e_result_code_t ta_terminal_system_information_async ( ta_object_t  terminal)

Request system information from the EFT Terminal.

Asynchronous version of ta_terminal_system_information. Callback function is ta_cb_terminal_system_information_completed.

Note
Set EcrData property before calling SystemInformation.
Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_third_party_app_data()

ta_e_result_code_t ta_terminal_third_party_app_data ( ta_object_t  terminal,
ta_object_t  data 
)

Send third_party_app_data to request EFT make a screenshot.

This is a "best effort" function.

Note
This method is only available if guide value_added_services is enabled.
Parameters
[in]terminalObject instance of type terminal.
[in]payloadObject instance of type third_party_app_payload.
Return values
ta_c_rc_okthird_party_app_data send to terminal.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentterminal is ta_object_invalid or not of type third_party_app_payload.

◆ ta_terminal_transaction()

ta_e_result_code_t ta_terminal_transaction ( ta_object_t  terminal,
ta_e_transaction_type_t  type,
ta_object_t  amount,
ta_object_t response 
)

Starts an EFT Terminal Transaction.

Note
The transaction parameters are taken from TransactionRequest terminal property since those do not change often if at all (default parameters).
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]amountObject instance of type amount.
[out]responsePointer to variable to write object instance to. Object instance is of type transaction_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is ta_object_invalid.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_transaction2()

ta_e_result_code_t ta_terminal_transaction2 ( ta_object_t  terminal,
ta_e_transaction_type_t  type,
ta_object_t  request,
ta_object_t response 
)

Starts an EFT Terminal Transaction.

Note
The transaction parameters are taken from TransactionRequest terminal property since those do not change often if at all (default parameters).
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]requestObject instance of type transaction_request.
[out]responsePointer to variable to write object instance to. Object instance is of type transaction_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentrequest is ta_object_invalid.
ta_c_rc_invalid_argumentrequest is not of type transaction_request.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_transaction2_async()

ta_e_result_code_t ta_terminal_transaction2_async ( ta_object_t  terminal,
ta_e_transaction_type_t  type,
ta_object_t  request 
)

Starts an EFT Terminal Transaction.

Asynchronous version of ta_terminal_transaction2. Callback function is ta_cb_terminal_transaction_completed.

Note
The transaction parameters are taken from TransactionRequest terminal property since those do not change often if at all (default parameters).
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]requestObject instance of type transaction_request.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentrequest is ta_object_invalid.
ta_c_rc_invalid_argumentrequest is not of type transaction_request.

◆ ta_terminal_transaction_async()

ta_e_result_code_t ta_terminal_transaction_async ( ta_object_t  terminal,
ta_e_transaction_type_t  type,
ta_object_t  amount 
)

Starts an EFT Terminal Transaction.

Asynchronous version of ta_terminal_transaction. Callback function is ta_cb_terminal_transaction_completed.

Note
The transaction parameters are taken from TransactionRequest terminal property since those do not change often if at all (default parameters).
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]amountObject instance of type amount.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is ta_object_invalid.

◆ ta_terminal_transaction_cashback()

ta_e_result_code_t ta_terminal_transaction_cashback ( ta_object_t  terminal,
ta_e_transaction_type_t  type,
ta_object_t  amount,
ta_object_t  amount_cashback,
ta_object_t response 
)

Starts an EFT Terminal Transaction.

Note
The transaction parameters are taken from TransactionRequest terminal property since those do not change often if at all (default parameters).
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]amountObject instance of type amount.
[in]amount_cashbackObject instance of type amount.
[out]responsePointer to variable to write object instance to. Object instance is of type transaction_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is ta_object_invalid.
ta_c_rc_invalid_argumentamount_cashback is ta_object_invalid.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_transaction_cashback_async()

ta_e_result_code_t ta_terminal_transaction_cashback_async ( ta_object_t  terminal,
ta_e_transaction_type_t  type,
ta_object_t  amount,
ta_object_t  amount_cashback 
)

Starts an EFT Terminal Transaction.

Asynchronous version of ta_terminal_transaction_cashback. Callback function is ta_cb_terminal_transaction_completed.

Note
The transaction parameters are taken from TransactionRequest terminal property since those do not change often if at all (default parameters).
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]amountObject instance of type amount.
[in]amount_cashbackObject instance of type amount.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is ta_object_invalid.
ta_c_rc_invalid_argumentamount_cashback is ta_object_invalid.

◆ ta_terminal_transaction_info_request()

ta_e_result_code_t ta_terminal_transaction_info_request ( ta_object_t  terminal,
ta_object_t response 
)

Receive the latest transaction information.

Parameters
[in]terminalObject instance of type terminal.
[out]responsePointer to variable to write object instance to. Object instance is of type transaction_info_request_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_transaction_info_request_async()

ta_e_result_code_t ta_terminal_transaction_info_request_async ( ta_object_t  terminal)

Receive the latest transaction information.

Asynchronous version of ta_terminal_transaction_info_request. Callback function is ta_cb_terminal_transaction_info_request_completed.

Parameters
[in]terminalObject instance of type terminal.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.

◆ ta_terminal_transaction_tip()

ta_e_result_code_t ta_terminal_transaction_tip ( ta_object_t  terminal,
ta_e_transaction_type_t  type,
ta_object_t  amount,
ta_object_t  amount_tip,
ta_object_t response 
)

Starts an EFT Terminal Transaction.

Note
The transaction parameters are taken from TransactionRequest terminal property since those do not change often if at all (default parameters).
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]amountObject instance of type amount.
[in]amount_tipObject instance of type amount.
[out]responsePointer to variable to write object instance to. Object instance is of type transaction_response. Object instance is retained.
Return values
ta_c_rc_okRequest finished successfully. Object instance written to response. Object instance has been retained.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is ta_object_invalid.
ta_c_rc_invalid_argumentamount_tip is ta_object_invalid.
ta_c_rc_invalid_argumentresponse is null-pointer.

◆ ta_terminal_transaction_tip_async()

ta_e_result_code_t ta_terminal_transaction_tip_async ( ta_object_t  terminal,
ta_e_transaction_type_t  type,
ta_object_t  amount,
ta_object_t  amount_tip 
)

Starts an EFT Terminal Transaction.

Asynchronous version of ta_terminal_transaction_tip. Callback function is ta_cb_terminal_transaction_completed.

Note
The transaction parameters are taken from TransactionRequest terminal property since those do not change often if at all (default parameters).
Parameters
[in]terminalObject instance of type terminal.
[in]typeTransaction type.
[in]amountObject instance of type amount.
[in]amount_tipObject instance of type amount.
Return values
ta_c_rc_okRequest started successfully.
ta_c_rc_invalid_argumentterminal is ta_object_invalid.
ta_c_rc_invalid_argumentterminal is not of type terminal.
ta_c_rc_invalid_argumentterminal has been disposed.
ta_c_rc_invalid_argumentamount is ta_object_invalid.
ta_c_rc_invalid_argumentamount_tip is ta_object_invalid.