Machine Attributes - Card Readers
Card Readers
Machine Attributes - Card Readers
How to configure POS and card acceptance settings for your device
- Parameters shown in screenshots may differ from your Machines page - availability varies by device configuration.
- If a parameter is missing, go to the Attributes tab and enable it from the available list.
- To apply any change: check the box next to the parameter > Actions > Update Queue > Actions > Restart Device.
Card Readers Overview
The Card Readers section is where you configure the core Point of Sale (POS) settings that determine how your Nayax device accepts and processes card payments.
This area includes a wide range of configuration options, so this guide focuses on the most important and commonly used attributes. These settings control key aspects of payment behavior, such as:
- The MDB communication level
- Currency formatting
- Supported card types
- Transaction triggers
- VPOS button behavior and reading sensors
Together, these configurations define how the device interacts with cards and manages payment transactions.
Card Reader Settings
Image AttachedSets the MDB (Multi-Drop Bus) communication level for the device. Match this value to the MDB level supported by your vending machine. A device restart is required after changing this setting.
| Value | Capability |
| 1 | Basic features (default) |
| 2 | Required for revalue functionality |
| 3 | Required for Always Idle state |
Controls how currency values are transmitted to the machine over MDB. The same number sent to the machine will represent a different monetary amount depending on this setting. This also affects the Default Credit amount.
| Setting | Value sent to machine | Interpreted amount |
| Decimal 0 | 10 | $10.00 |
| Decimal 1 | 10 | $1.00 |
| Decimal 2 | 10 | $0.10 |
Specifies which card networks and standards the device accepts. Set this value based on the country and the card schemes active in your market.
| Value | Market / Use case |
| Maestro+SDA+DDA+BNP | Europe (EU) and Australia EMV |
| VISA Cless MSD | United States and Australia Non-EMV |
| Interac+InteracV41+SDA+DDA+BNP | Canada EMV |
| VISA Cless MSD | Canada Non-EMV |
Card reader MDB Level - This parameter should be set according to the machine MDB level.
MDB level 1 gives basic features.
MDB Level 2 is needed for revalue.
MDB level 3 is needed for "Always Idle" state.
Decimal Place - Defines the way currency values are sent to the machine.
For example - Value sent to machine: 10
With Decimal 0: amount is 10$
With Decimal 1: amount is 1.0$
With Decimal 2: amount is 0.1$
EMV contactless Transaction Limit - This parameter defines the maximum amount that can be approved in a contactless EMV transaction
Extended Cards Support - Defines the types of credit cards accepted.
The value should be set according to the country.
Transaction Start Ignore List - Setting "Ignore EMV Cless", will prevent Contactless EMV cards from starting a transaction.
It would still be possible to pay using contactless EMV cards after product selection.
Transaction Start Method - Define how to start a transaction.
Keep in mind that some options need to be supported on the machine side as well.
VPOS Button Function - For Preauthorization transaction flow select: "1 - External Cancel".
For Preselection transaction flow select: "5 - Btn Start/Card Start + External Cancel".
For Pulse increments select: "2 - Pulse Price Roll".
VPOS Card Options - This Parameter defines where the Credit card's information is read from.
VPOS Read Source Enabled - Defines which card reading sensor is activated on the VPOS.
EMV & Contactless
Image AttachedSets the maximum transaction amount that can be approved via a contactless (tap-to-pay) EMV card. Transactions above this threshold require an alternative method, such as chip insertion. Setting this to 0 removes the limit check entirely.
Controls which card types are blocked from starting a transaction at the device (before product selection).
| Value | Behaviour |
| Ignore None | All card types can start a transaction (default) |
| Ignore EMV Cless | Contactless EMV cards cannot start a transaction, but can still complete payment after product selection |
Card reader MDB Level - This parameter should be set according to the machine MDB level.
MDB level 1 gives basic features.
MDB Level 2 is needed for revalue.
MDB level 3 is needed for "Always Idle" state.
Decimal Place - Defines the way currency values are sent to the machine.
For example - Value sent to machine: 10
With Decimal 0: amount is 10$
With Decimal 1: amount is 1.0$
With Decimal 2: amount is 0.1$
EMV contactless Transaction Limit - This parameter defines the maximum amount that can be approved in a contactless EMV transaction
Extended Cards Support - Defines the types of credit cards accepted.
The value should be set according to the country.
Transaction Start Ignore List - Setting "Ignore EMV Cless", will prevent Contactless EMV cards from starting a transaction.
It would still be possible to pay using contactless EMV cards after product selection.
Transaction Start Method - Define how to start a transaction.
Keep in mind that some options need to be supported on the machine side as well.
VPOS Button Function - For Preauthorization transaction flow select: "1 - External Cancel".
For Preselection transaction flow select: "5 - Btn Start/Card Start + External Cancel".
For Pulse increments select: "2 - Pulse Price Roll".
VPOS Card Options - This Parameter defines where the Credit card's information is read from.
VPOS Read Source Enabled - Defines which card reading sensor is activated on the VPOS.
Communication
Note:
- The parameters shown in the screenshots may differ from the parameters available on your Machines page due to different device configurations
- If some attributes are missing, go to the Attributes tab and enable the ones you need from the lists provided
- To apply changes to the device, make sure to check the box of the relevant parameter > click "Actions" > Update Queue. Then, click on "Action" again > Restart device.
Communication
In the "Communication" section, we will define how the device will communicate (VPN, MQTT, Ethernet) as well as extract some data regarding the network.
Communication Mode
Image AttachedCommunication Mode - This Parameter will dictate the Unit Communication Mode:
Disabled - Unit will connect using regular APN (Dynamic IP - SIM)
VPN Enabled - The unit will connect using VPN (Static IP - SIM). If the VPN fails, the unit will connect using APN.
MQTT Enabled - Unit will connect using APN and MQTT, once configuring this parameter all necessary MQTT configuration will be sent automatically (user name, password, etc..).
VPN Only - Unit will connect using VPN (No Fall-back)
Keep Alive Poll Interval (sec) - Defines the Keep-Alive time interval in seconds. The default value is 2500 sec, meaning the unit will communicate with the server every 2500 sec.
WPN - Primary Address - Primary APN Server address.
When the unit is configured to use APN, this will be the first address the unit will try to connect to.
WPN - Backup Address - Backup APN Server address.
When the unit is configured to use APN, this will be the third address the unit will try to connect to.
VPN - Primary Address - Primary VPN Server address.
When the unit is configured to use VPN, this will be the first address the unit will try to connect to.
VPN - Secondary Address - Secondary VPN Server address.
When the unit is configured to use VPN, this will be the Second address the unit will try to connect to.
VPN - Backup Address - Backup VPN Server address.
When the unit is configured to use VPN, this will be the third address the unit will try to connect to.
Thank you!
Did you find this article helpful?