.. _everest_modules_RsPaymentTerminal:

#################
RsPaymentTerminal
#################
| Payment terminal module for Feig devices.



************************
Auto-Generated Reference
************************


Module Configuration
====================
| **ip**: *string* <required>
|  IP Address of Feig terminal, like "192.168.0.1"
| **feig_serial**: *string* <required>
|  Serial of Feig terminal. Typically a seven characters long string like "ABCD123".
| **terminal_id**: *string* <required>
|  Payment terminal ID.
| **currency**: *integer* <optional>
| *default: 978*
|  Currency in ISO 4217 format.
| **pre_authorization_amount**: *integer* <optional>
| *default: 2500*
|  Pre authentication amount in Cents.
| **read_card_timeout**: *integer* <optional>
| *default: 2*
|  The time (is seconds) to wait for a card to be read.
| **read_card_debounce**: *integer* <optional>
| *default: 2*
|  The debounce time (in seconds) after a successful card reading. The parameter prevents re-reading the same card.
| **read_card_control**: *integer* <optional>
| *default: 208*
|  The ZVT card reading control (Tlv tag 0x1f15) used when polling for cards. The default 208 (0xd0) detects cards without sending commands to them; the token of a bank card is then taken from the `bank_session_token` interface. The value 192 (0xc0) fully reads the card: slower, but the token is then derived from the physical card, which allows stopping a session by presenting the same card again. With 192 the `bank_session_token` interface is not used and the caller of `token_validator` must deliver the invoice token in the `additional_info` of the id token, in an entry of type `invoice_token` - validation is rejected otherwise.
| **transactions_max_num**: *integer* <optional>
| *default: 1*
|  The maximum number of concurrent transactions. The Feig terminal will reject a transaction if it would exceed the maximum number of concurrent transactions - in this case you need to finish a transaction to allow a new one.
| **password**: *integer* <required>
|  Password for the Feig terminal.
| **end_of_day_max_interval**: *integer* <optional>
| *default: 86400*
|  The maximum time (in sec) between end of day jobs. Payment backends might force the payment terminals to run them regularly. Defaults to one day.

Provides
========
| **token_provider**: :ref:`auth_token_provider <everest_interfaces_auth_token_provider>`
|  Provides an authentication token from the Feig terminal.
| **token_validator**: :ref:`auth_token_validator <everest_interfaces_auth_token_validator>`
|  Reserves the `pre_authorization_amount` from a bank card. With `read_card_control` 192 the caller must deliver the invoice token in the `additional_info` of the id token, in an entry of type `invoice_token`; otherwise the token id itself is used as the invoice token.
| **payment_terminal**: :ref:`payment_terminal <everest_interfaces_payment_terminal>`
|  Provides all the commands specific for bank cards handling

Requirements
============
| **session**: :ref:`session_cost <everest_interfaces_session_cost>` 0..1
|  ignore:
|   vars:
|     - default_price
| **bank_session_token**: :ref:`bank_session_token_provider <everest_interfaces_bank_session_token_provider>` 0..1

********
Metadata
********
Authors
=======
| embedded-team@qwello.eu

License
=======
| https://opensource.org/licenses/Apache-2.0