Overview Machines General Tab | Operations
General
When logging onto the website at us.nayax.com, it is good practice to get familiar with the Machines page as that is where "the magic happens". This is where most of the changes to the device take place and where most issues can be resolved with troubleshooting and testing. In this article I am going to give a high level overview of how to find the machines page and how to update the basic information on the machines page
First, to access this page you will go to Operations > Machines and it will take you to a page that looks like this
First, to access this page you will go to Operations > Machines and it will take you to a page that looks like this
From here you will come to a page that is blank initially but you will be able to populate this page with your company information as seen here
From here we will cover all Parameters and the attributes in those parameters in the General Tab after you select a machine in the Nayax website as seen here
In this section we will discuss all of the sections in the General Tab to give information and context about what each section means in regards to the machine configuration and overall performance. Depending on what type of machine you have, the configuration may be different so we will give a high level overview of the information needed for understanding what each field means in regards to the configuration that is needed for the card reader and the machine.
General Information
General
From here you will be able to see your company information along with some information in the General section. Each attribute in the general section will be populated when you choose your machine and we will go over the General section so you can accurately assess the information on your machine in order from top to bottom in the general section. In the General section, some information is required and have been highlighted where the other sections in the general tab are optional and can be filled out at your discretion. We will cover the highlighted sections to make the most important and relevant information is populated.
Operator - This is where your company information would be populated
Machine Type - This information determines the icon that is next to your virtual machine. The icon is completely your choice but has no bearing on the performance of the device
Machine model - This preset comes with a specific configuration based on your machine needs and can be changed if needed.
NOTE: When changing the machine model, please reset the device to default settings and send restart before loading defaults. This will allow the device to be cleared and configured correctly to make sure all previous settings have been removed.
Machine Profile - This field is not required to be filled out but the choice of what information is there is your choice
Machine Group - This information is used to identify a Group that the machine would belong to and can be used to determine how a campaign works and how Monyx is used.
Sales Source - This is used to determine if your inventory is updated in real time (Live Transactions) or updated with a separate VMS (Vending Management System) using DEX/DDCMP
Machine Reference - This information is required but is used to identify your machine by name along with the serial number. In most cases, this information looks something like this "DU-7Xi5snqneA6D". This information can be changed to a name to identify your machine in the Nayax website and the MOMA App
Machine number - While this field is optional, it is good practice to put the serial number of the card reader in this field so it can be seen by anyone that is looking for the machine which can be seen on the back of the card reader.
Machine Serial number - This information is optional and can be used with the physical machine serial number so that information will be available if needed
Status - This is used to set the machine to be either active or not active. The status of the machine will affect the card reader to accept cards. If the machine is active you will see the icon either red or green if the card reader is communicating. If the machine is not active you will see the icon colored grey regardless if the card reader is communicating or not.
Labels - This field is optional where you can create a label for your machine. This field is purely cosmetic and can be used at your discretion as it has no bearing on the machine and device performance.
Hardware
Machine ID - This information is populated automatically when the machine is created online. Every machine ID is unique and can be used to identify the machine if needed.
Smart Sticker - While this information is optional, this number would come directly from the smart sticker which is uploaded using the MOMA app. To upload the smart sticker with the MOMA app, please see our guide for uploading the smart sticker using the MOMA app.
Device number - This information is the serial number of the card reader and depending on what type of device you have the number will be either 6 or 16 digits. For example, a VPOS touch would look something like this "0434555877890431" and the AMIT device would have a number that looks like "0000000000984751". While the AMIT device does have 16 digits as well, the numbers that matter the most is the last 6 digits.
VPOS - This number will be different depending on which device serial number is under the device number field. When you attach a VPOS touch to the device number field, the number in the VPOS field will be the same. This indicates the type of device that is being used as the VPOS touch is an all-in-one device where AMIT and VPOS make up the unit as a whole. If there is an AMIT in the device number field, the VPOS unit will be different as theses are 2 separate devices and the serial number will be 10 digits instead of 6 or 16 digits. If an AMIT device is attached, you can either manually add the VPOS unit or you can wait until the AMIT communicates with the network and the VPOS number will populate automatically.
Cash box - This field has no relevance with regards to machine or device function and is largely not used in configuring a machine in the Nayax website
All other fields in this section can be filled out at your leisure as they are not required for the machine and device to accept card payments
Card Reader
In this section, We will view the typical settings when it comes to EMV card payments that can be processed on the card reader in the screenshot above to show how each attribute works when processing a card payment using EMV. While the card reader attributes can be altered to other sets, we will cover the more up to date attributes needed to process EMV payments. If you have any questions about other attribute sets, please reach out to our technical support department for any questions.
Card Reader MDB Level - In this field, this is where the level of the MDB is established based on the type of machine the card reader is attached to. There are 3 levels of MDB: Level 1, Level 2 and Level 3. Each level means something different and works differently again, based on the machine the card reader is attached to. We will discuss each MDB level below;
MDB Level 1 - This level is common on most machines such as Vending Machines, Water machines, Car washes, Dog washes, etc.... These machines typically use this level as it as a method to listen and understand the MDB traffic from the device and the machine interchangebly. This level processes information with the transactions along any information that is needed to keep the card reader in sequence with the machine it is attached to.
MDB Level 2 -
MDB Level 3 - This level is used to Communicate with the machine like Marshall protocol but is not Marshall. This level works as a Slave - Master relationship where the machine dictates the flow of the transaction. The item has to be selected first before the card reader is able to take a payment just like Marshall but the difference here is the card reader works with a computer inside the machine and uses the MDB protocol instead of a comm port. MDB level 3 is determined by the machine and if there is any question about what the machine requires, please reach out to the machine manufacturer.
Contactless Delay Start - This attribute is used to determine the amount of time the card reader takes to recognize a contactless/NFC payment and the time is calculated in Milliseconds (Ms) so 1000 Ms = 1 second. This can help with how fast the card reader reads the card when it comes to contactless transactions. This can be adjusted to fit your preference for your machine and card reader
Decimal Place - This used to note where the decimal place is with the amount of the item purchased in the machine. The Choices here are 0, 1, and 2. 2 is the most commonly used as the system processes transaction information with the decimal place to reflect the amount of the item that was purchased.
EMV Contactless Transaction Limit - This attribute is used to determine the amount that can be authorized when a card is used with a contactless payment. This amount would need to be more than the default credit on the machine in DCS.
Extended Card support - This attribute is used to determine how the card is read in the card reader and used to determine whether the card is using the EMV feature or not.
LED Configuration - This attribute is define the LED display that is shown on the card reader.
Reader Failure - This attribute is used to determine the number of failures the card reader would need before the an alert is generated for card swipe error
Scale Factor - This attribute is used to scale monetary information that is transferred between the card reader and the VMC. This means the information that comes with the money that is used to make a purchase is transferred from the card reader to the machine depending the number in the field. Most commonly the number is 1 which used to indicate a 1:1 information transfer between card reader and machine.
Transaction Start ignore list - This attribute is used to determine what to ignore when the transaction is being processed. It is best to set this attribute to ignore none to make sure the card reader knows to not ignore anything when processing card sales.
Transaction Start method - This attribute is used to determine how a transaction is started with a card transaction.
VPOS button function - This attribute is used for VPOS units and not the VPOS touch device. The button in question on the VPOS unit is the start stop button. In most cases, this button is not often used the card can be either swiped, tapped, or contactless with EMV settings.
VPOS card Options - This attribute is used to determine how the card is read in the card reader and is based upon either EMV settings or swipe settings.
VPOS Version - This Attribute is used to state the firmware version of the VPOS or VPOS touch unit
VPOS Read Source Enabled - This attribute controls the VPOS read Sources. All read sources can be found on the question mark when you hover your mouse over it.
VPOS SAM Number - VPOS SAM number is used to display the SAM (Secure Access Module) number For various applications that utilize SAM (Secure Access Module)
VPOS Serial - This attribute is used to display the serial number that is sent to the server during the card transactions.
Communication Mode
In this section we will cover the communication Parameter and the attributes that are needed to use this parameter effectively as this parameter is used to enable/disable 2 way communication to use Monyx.
Communication Mode - This parameter used to Enable 2 way communication for the card reader and should be configured based on the cellular carrier for the card reader.
Keep alive Poll Interval (Sec) - This parameter is used to regulate device communication to the server which is indicated in seconds
Mobile network Name - This parameter is used to display the cellular carrier for the card reader
Device Features
In this section we will cover the attributes that make up the Devices Features to highlight the different configurations and what needs to be enabled to make sure the needed attributes are utilized on the card reader. These features are used to enable both manual and automated processes when using the card readers.
Assigned Technician Cards - This attributes holds the technician cards that are assigned to the machine with their enabled functions and features along with the expiration dates. 5 cards are the maximum number of cards that be assigned to a machine at a time
BT1 Red button Long Press - On the AMIT device, This can be configured for a long press on the red button for any function that you choose. On the VPOS touch, depending on what this function is configured for, this would be represented in the technician menu as the VPOS touch does not have a red button to long press
BT1 Red Button Short Press - On the AMIT device, This can be configured for a short press on the red button for any function that you choose. On the VPOS touch, depending on what this function is configured for, this would be represented in the technician menu as the VPOS touch does not have a red button to short press
BT2 Yellow Button Long Press - On the AMIT device, This can be configured for a long press on the yellow button for any function that you choose. On the VPOS touch, depending on what this function is configured for, this would be represented in the technician menu as the VPOS touch does not have a yellow button to long press
BT2 Yellow Button Short Press - On the AMIT device, This can be configured for a short press on the yellow button for any function that you choose. On the VPOS touch, depending on what this function is configured for, this would be represented in the technician menu as the VPOS touch does not have a yellow button to short press
Data Reduction -
Device Boot Version - This attribute displays the boot version that is displayed upon startup
Device Local Time Zone - This Attribute displays the time and date that comes from the server
Device PCB Version -
Device Serial - Nayax Device hardware serial number
Device software Version - This Attribute displays the firmware version of the card reader
Door Open Default State - This attribute will enable door open alerts and indicate what is the normal state of the door switch
Gtrace Request - This attribute is used to request a gtrace and you can determine the size of the Gtrace
DEX/DDCMP
DEX Read Retry Counter - This attribute is used to indicate the number of DEX read retries that the card reader will do in case of unsuccessful read of DEX button after all time fails.
DEX Read Retry Period (Sec) - This attribute indicates the time interval between each DEX read in case parameter "DEX Read Retry Counter" is activated
DEX Reads Schedule - This attribute is used to indicate the times for the DEX read to occur. These times are indicated in Military Time and 6 is the maximum number of DEX reads for this attribute.
DEX type - This attribute is used to indicate specific DEX types for specific cases and machines. The default for this parameter is DEX/UCS which works for most machine and VMS types.
Offline DEX alerts - This attribute enables the user to search for alerts in the DEX, which is read by the device.
Language/Audio
Audio Language - This Attribute is used to determine the language for the card reader when using the card reader
Audio Volume - This Attribute is used to adjust the volume on the card reader. The maximum volume is 85
LCD Primary Language - This attribute is used to determine the primary language for the LCD
LCD Secondary Language - This attribute is used to determine the secondary Language for the LCD
Removing Audio Message - This attribute is used to remove an audio message(s) from the card reader to help customize the card reader to your preference
SRV to LCD Lang - This attribute is used to determine the language to the server will send message to LCD
LCD
Cash Only Message - This attribute is used to determine the cash only message on the card reader and can be changed to anything you like. This message appears on the card reader
LCD message - This attribute is used to indicate what the LCD message is displaying on the card reader
NOTE: This attribute will only display information from the VPOS unit and not the VPOS touch as the VPOS touch uses graphics and the VPOS unit uses text
NOTE: This attribute will only display information from the VPOS unit and not the VPOS touch as the VPOS touch uses graphics and the VPOS unit uses text
LCD Status - This attribute is used to indicate the error message displayed on the LCS and is sent every keep alive and shown only if the cash only message is under 16 characters
Welcome Message - This attribute is used to change the message on the VPOS unit and can be customized to your preference
NOTE: This attribute will only display information from the VPOS unit and not the VPOS touch as the VPOS touch uses graphics and the VPOS unit uses text
NOTE: This attribute will only display information from the VPOS unit and not the VPOS touch as the VPOS touch uses graphics and the VPOS unit uses text
MDB
Cashless MDB Address - This attribute is used to define the protocol to work with - MDB or other.
Disable Sending Cash Sale Notification - This attribute is used to allow the sales information from a cash sale to be reported in the Nayax platform. If this box is checked that means the cash sale information will not be visible in the sales reporting
Maximum Response time - This attribute is used to indicate the maximum length of time a reader will require to provide a response to any command from the VMC
MDB Flag - This attribute is used to determine the 'language' for the card transaction from the card reader to the machine. This can change from machine to machine. Please review information about the machine when making the change in the Nayax platform
Poll Stop Event Timeout - This attribute is used to define the timeout before reporting to the server that MDB polling has stopped, device waits the defined amount of time before sending out this alert.
Post Cash Sale Timeout - This attribute is used to set the minimal amount of time between cash sale reports. If a cash sale report is sent, and then another cash sale report is triggered by the machine within the configured time, the 2nd report will not be sent.
Modem
Current Cellular Technology - This Attribute is used to determine the Current Radio Access Technology. Each technology is determined by the number that is in the field. Please refer to the question mark button next to the attribute to find out what each number is referencing
Modem FW Build number - This attribute is used to display the build number for the card reader. This number will populate based on build number with the firmware when the device reports when powering up.
MODEM IMEI - This attribute displays the IMEI number that is embedded in the card reader after the device communicates with the cellular network.
Modem Model - This attribute is used to display the modem model for the card reader and will populate after the device communicates with the cellular network
Modem Software Version - This attribute is used to display the software version of the card reader after the device communicates with the cellular network.
Payment
Choose Product Timeout (sec) - This attribute is used to determine the amount of time that is needed from the credit provided to the machine to the product selection.
Default Credit - This attribute is used to determine the maximum amount a card reader can authorize for when using a card to purchase an item. This format does not include the decimal point but is still implied when making a change to this attribute
EMV Price Table - This attribute is used to determine the option to work with machine prices instead of server prices upon EMV Credit Card usage and enables to add extra charges in addition to the machine price.
EMV Transaction Floor Limit - This attribute defines which amount should require to go online for authorization before releasing
Payment Flags - This attribute is used to control the way a prepaid card works with the card reader. This will control the flow of the transaction and all pertinent information between the server, payment card and the card reader itself. Each payment flag does something different so please check the parameter settings before making changes.
SIM Card
CLI (Calling Line Identification) - This attribute is used to identify the cellular number the device is using when communicating with other devices or servers.
Displayed CLI - This attribute is used to identify the cellular number the device is using when communicating with other devices or servers.
SIM Serial Number - This attribute is used to display the serial number of the SIM card that the card reader is using when communicating.
VMC
MDB Level - This attribute is used to display the MBD level of the machine the card reader is attached to
VPOS Touch
Active Brightness - This attribute is used to adjust the brightness on the card reader while the device is running a transaction
Idle Mode Screens - This attribute is used to override the idle screens that are on the card reader when configured in the Nayax website
Menu Functions - This attribute is used to determine the buttons in the menu of the card reader.
Menu Timeout - This attribute is used to determine the amount of time that is allotted to use the menu before timing out
Support Phone Number - This attribute is used to display the support phone number on the card reader in the menu
Support WEB - This attribute is used to display the website for Nayax
Technician Code - This attribute is used to configure and change the technician code on the card reader
Vend Flow Options - This attribute is used to determine the actual flow of the transactions when a card is being used.
Did you find this article helpful?