FAQ- Device (VPOST/ VPOSM)
Device being stuck on "Nayax" screen during powerup- communication issue:
This could happen due to multiple reasons:
- Modem connection issues/bad cellular reception/ connected to ETH and the connection is poor. Do you happen to use ETH? Or have the devices near something that would block cellular reception?
- Wrong modem type (for example European modem in the US) or a modem that is not too strong. Which modem type are you using?
- SIM card not installed/supported (for example a SIM card that you bought outside of Nayax)/all used up. Which SIM are you using?
- Antenna is not connected properly/ wrapped up around itself/pointing downwards/ around a metal box. Can you have a look at it?
- If the device gets to the Nayax logo, then crashes- Do you have 24V power source with minimum 1.5A?
Device is connected to the Marshall cable but the device is in Cash Only
Which COM have you connected to your board? Is it COM2 as mentioned in the "Installation Guide"? If you're using a Chipi-X (specific USB to COM adaptor. The only one which grants support privileges!)- does the Chipi-X seems to be connected to a hub- try connecting it directly to the PC.
Everything is connected as expected but things still doesn't work- what now?
- Check the parameters in Nayax Core
- Check that the physical connection fits the instructions as in the Installation Steps
- If OK – please reboot the device:
- disconnect from power,
- wait for the screen to go black
- power the device back
- Check that in the code of the SDK you changed the COM port to the relevant one
- Compile and Run the SDK: a. Do you see the peripheral simulator's menu and pairing process displayed in the prompt window? b. Do you see in the log file that the Pairing process ended successfully?
Using 12V power source (instead of 24V)
12V it is the verge of not being sufficient power for the device to operate (it would make it hard for the device to distinguish the difference between '0' and '1'). It can also be the cause of packets not being able to be sent/received properly (retries) as well as CRC errors. It can also cause the device to crash during powerup as during the powerup process there is a spike in energy consumption. In addition, should you be using Chipi-x it also consumes some energy, causing said 12V to be even more likely to not be sufficient for valid operation of the device.
Changing Idle screen/customization of screens/ UI control
At the moment, only the following modifications are available:
-
At IDLE state, you can select the pictures/animations to be displayed over our DCS back office. You can also add some customized image e.g. displaying the logo of your company.
-
Change the "Please select a product" title
-
Or change the title at idle mode:
-
At end of transaction, you can remove the "Thank you and good bye" message: both picture and voice message will not be displayed/played.
For VPOS Touch- During the transaction process, there is not much to do in terms of UI and both messages and images/animations cannot be customized. Regarding VPOS Media- this is a new product that is at the final stages of development, there is a possibility of editing the screens and animations- but this section would be updated once it would be released.
Firmware update process
VPOST: The firmware update is made out of 2 parts- the MAIN update and POS update. For the MAIN update you'd see "gloader" on the top of the screen and a percentage next to it. Once completed the device would reset itself and start downloading and updating the POS- please do not touch it until the device resets itself, as the device's screen would also seem black once the POS is erased and being updated. After completion the VPOST would power itself up and would be in idle mode. This whole process usually takes 30-60 minutes, so keep that in mind. VPOSM: TBA
Device's communication with Nayax's servers- ETH/fallback mechanism
We highly recommend that even if customers are planning on using ETH connection- that they'd leave the SIM card installed and antenna connected as a fallback mechanism, as we've had many customers who's had "hiccups"/ issue with the ETH connection and in that case the VPOST/Onyx would try and use the cellular one.
Decimal place
The Decimal place is a parameter in Nayax Core which is forwarded to the device. In Marshall, said value is forwarded to the peripheral via the Marshall command "Config" - which is sent as part of the Pairing process. On its end, the machine should calculate the following value: X = 10 ^ "Decimal place" (i.e. 10 power "Decimal place") And for each transaction, multiply the price set in the SDK by this value and send this value to the device. For example: Decimal place = 2 Price = 30 Euros Price to be sent to device: 30 * (10 ^ 2) = 30 * 100 = 3000
• FYI, Credorax accepts transactions from 10 cents and above only. So, if you send 1 as price and decimal place is 2, we will eventually send to Credorax: 1 / 100 = 0.01 Euro and transaction will be declined.
SIM not working
The SIMs recognition depends on the device's APN addresses. Meaning if the specific SIM does not exist there, it won't work. If you encounter an issue with a SIM (received with your device / bought from Nayax)- please contact the Support team- [email protected]
Removing the X button on the device during authorization
Removing the X option can be done by changing the "VPOST button function" to "VPOS cancel button during authorization"
Hardware questions
Q: Is it a true RS232 interface with a level shifter or UART signals with voltage level 5V/3.3V? A: Yes true RS232 with level shifter. (The RS-232 standard talking about −15 to −3 V and +3 to +15 V. The electric components such as we are using are working about ±7V.)
Q: Are any HW handshaking signals (RTS/CTC) needed? A: No, only RxD/TxD/GnD is used.
Updated 16 days ago