¶ Instructions for customers
Table of contents
2.1 View the status of your terminals (menu Terminals) 3
2.1.1 Connect notifications in Telegram 5
2.2 Bind the terminal to the bank tid (menu Terminals - Actions - Change) 6
2.3 Send the command to the terminal (menu Terminals - Actions - Send command to terminal) 7
2.4 Popular commands 8
2.4.1 Set up payment auto-return (menu Terminals - Actions - Send command to terminal - Payment auto-return) 8
2.4.2 Set up Start credit (menu Terminals - Actions - Send command to terminal - Start credit) 9
2.4.3 Set the terminal to Always Idle 9
2.4.4 Switch the terminal to Slave mode (under control of an external modem/controller) 9
2.4.5 Update the firmware of the terminal 9
2.5 View transactions for your terminals (menu Reports - Transactions) 11
2.6 Cancel the transaction (menu Reports - Transactions - X) 13
2.7 View terminal logs (menu Reports - Terminal Logs) 13
2.8 Cash register menu 13
2.8.1 Divisions 16
2.9 Set up payment by Qr code 17
2.10. Bonus system 17
2.11. Communication at the time of delivery of goods 20
2.12. Additional terminal settings 21
2.13. Using templates 23
2.14. Subscription fee 24
2.15. NFC tags 25
Appendix 1. List of commands to the terminal and their parameters 27
Appendix 2. Transcript of terminal logs 40
¶ Login to the portal
After registration on the portal, which is carried out by the seller of terminals, the client receives an e-mail with a link to the site p.vendista.com and login data - login and password.
¶ You can do the following in the portal:
¶ 2.1 View the status of your terminals (menu Terminals)
The following data is output:
- ID - the terminal number, which is also displayed on the terminal screen in the lower left corner;
- TID - identifier (tid) issued by the bank and linked to the terminal;
- Version - firmware version of the terminal;
- Operator - the operator to which the terminal was last connected. The GSM signal strength is indicated in brackets. If it is less than 10, the terminal may work intermittently and it will be necessary to install an external antenna. You can also replace the SIM card yourself;
- Online per hour/day - the percentage of time the terminal was online per hour/day;
- Latest online - time of the terminal's last connection to the server. If the connection was made less than 10 minutes ago, the line will be highlighted in light color, otherwise - in dark color;
- Client - name of the organization owning the terminal;
- Send Cash Sales - If unchecked, checks for cash sales will not be generated;
- Send non-cash sales - if this checkbox is unchecked, checks for cashless sales will not be generated;
- Comment - field for your comment (for example, address of terminal installation, number of the machine or other information of your choice).
Deciphering the colors of the terminals:
- White - the terminal is online and operating normally;
- Light gray - the terminal has been out of service for more than 10 minutes;
- Gray - the terminal has been out of service for over a month;
- Orange (entire line) - the terminal is unplugged;
- Light yellow (operator) - prepaid SIM card is installed in the terminal
- Pink - the dispenser is in error state, requires adjustment/repair/refueling/rebooting of the dispenser (the terminal does not need to be rebooted, the problem is with the dispenser);
- Brown - sim card requires updating;
- Black - sim card is installed in the terminal, which must be replaced (operator has deactivated it).
Decode the firmware version of the terminal:
XX.YY.Z
XX - version number of the Main Firmware
YY - Main Firmware version number
Z - version number of Bootloader (it is a special program inside the terminal, which loads new firmware from the server). Bootloader does not affect the Main firmware and vice versa.
To sort the table by any column, click the up/down arrow next to the column name. To filter table rows by a certain text, fill in the Search by table field and click the Apply button. The search will be performed for all columns of the table.
If your terminal is not listed, contact the terminal vendor from whom you purchased the terminal.
¶ 2.1.1 Connect notifications in Telegram
To receive notifications about the status of the terminal(s), reports on sales, returns, etc. follow the instructions provided when filling out the Customers - Telegram notifications After that, fill out the menu section in the Users portal - notifications subscription. The checkbox “Enable notifications” should be ticked, the rest should be ticked if you would like to receive those notifications. After the settings have been applied, click the Save button
If you want to receive notifications to multiple numbers, enter the numbers via space or comma in the appropriate field in the Clients and Events Subscription section. The bot must be added to contacts for each number, otherwise notifications will not be sent.
To change the time zone to display the correct time of bank operations, go to the Users - Choose the line - Pencil icon. And select the value from the drop-down list. Click Save to apply the setting
The default time zone is set to GMT+4.
If necessary, you can change your password on the same page on the portal.
¶ 2.2 Bind the terminal to the bank TID (menu Terminals - Pencil icon - Edit)
Clicking on the Edit (pencil) icon to the right of the desired terminal takes you to the Edit Terminal screen.
Here you can select a processing server for making payments. To change it, follow the instructions in the Switching processing servers section. Assign the TID - bank payment key to the terminal, which will be used to send payments from this terminal to your current account. You can also add an arbitrary comment. After making changes, do not forget to click the Save button.
If one or more of your terminals are missing a TID, you do not need to go through the procedure of filling in the "Customers" section. Simply create an application at https://p.vendista.com/Tickets with the type "Additional TID" and specify the required number of additional TIDs.
You can assign a division to the terminal so that only the user of that division can see information and reports on the terminal. Instructions on how to create a subdivision can be found in section 2.8.1 "Subsection" below in the instructions.
¶ 2.3 Send the command to the terminal (menu Terminals - Actions (Last column) - Send command to terminal)
To send a command to the terminal, click on the "airplane" icon (Send command to terminal) located to the right of the selected terminal. The command can include changing settings, rebooting, firmware upgrade and other. A command can contain from 0 to several parameters, when a command is selected, all parameters are automatically filled with default values. Description of all commands and parameters is presented in Appendix 1.
The command can be sent to one or several terminals. To do this, you can specify the terminal IDs in the "Terminal ID(s)" field with commas or dashes. The command will be sent only to the terminals to which the user has access to. It is not possible to send the command to another terminal.
Previously sent commands are displayed at the bottom of the page. A new command will have the status "In progress". To find out the current delivery status, you need to refresh the page.
If the terminal is not connected to the server when the command is sent, the command will be sent immediately after the terminal is connected to the server. The server tries to deliver the command to the terminal within 24 hours, and if delivery fails within this time, the command will be canceled.
¶ 2.4 Popular settings
¶ 2.4.1 Set up payment auto-return (menu Terminals - Actions - Send command to terminal - Payment auto-return)
With the help of the command Auto return of payment you can configure the behavior of the terminal in case of unsuccessful transfer of paid goods. The parameter specifies the maximum time (in seconds) between payment acceptance and goods delivery. If during this time the goods are not dispensed, the payment amount will be returned to the card. If there are problems before the goods are issued (for example, the next payment was made), the terminal will return the money immediately, without waiting for the timeout. If you set the parameter value to 0, no refund will be made on the initiative of the terminal.
In addition, you can use Server Auto-Return of payment. Its difference from the usual one is that the refund will take place even if connection with the terminal is lost. If the server does not receive a confirmation from the terminal about the delivering goods within the timeout period, it will return the money. To activate this function, on the "Edit terminal" page, click the Use server auto-return of payment checkbox and set the timeout.
After activating auto-return, two types of notifications will come to Telegram:
- "Refund" is a normal auto-return when an item is not returned;
- "Unfounded return" is an auto-return after which the item was issued free of charge. This can happen if the goods are not dispensed in time during the auto-return timeout. To avoid unjustified returns, it is necessary to increase the timeout time or set the dispenser in the machine faster.
¶ 2.4.2 Set up Start credit (menu Terminals - Actions - Send command to terminal - Start credit)
"Start credit" is a credit that the machine sends at the beginning of the session after pressing the terminal screen. By default, the starting credit is set on the terminal in the amount of 100 usd. If the maximum price on the machine is higher than this amount, it is necessary to send the Start credit command. The parameter sets the credit value in cents. In addition, it is necessary to make a similar setting with the Maximum Credit command.
¶ 2.4.3 Set the terminal to Always Idle
Two commands must be sent for the mode to work correctly:
- Always Idle = 1;
- MDB terminal settings: Reader Level = 3.
The mode must also be enabled on the vending machine for correct operation.
¶ 2.4.4 Switch the terminal to Slave mode (under control of an external modem/controller)
Send command: Basic operating mode = 1.
To return to MDB mode, send Main operating mode = 1.
¶ 2.4.5 Update the firmware of the terminal
The default firmware of the terminal is Basic. You can change the firmware option in the settings menu (Terminals - pencil) by selecting the required option for the corresponding operating mode from the drop-down list:
0| Basic - used for MDB, Pulse, Tips/donations and Three-Button Device modes
2| Wi-Fi - firmware for terminals working via Wi-Fi module, for information on how to configure and connect the module see Connecting WiFi module to Vendista v2
3| Micromarket - firmware for the terminal Vendista-M, details of setup and connection read in the section Vendista-M terminal installation instructions
4| Gashapon - see the description of the solution in the section Connecting the Gashapon 5| Firmware Repairer - mode for repairing damaged flash memory of the terminal according to the instructions Firmware Update with disabled (black) screen
Save changes on the page. Return to the command sending page (Terminals - airplane). Select and send the command - Update Firmware.
In the "Version" line leave the default value - then the latest current firmware will be sent to the terminal. Or adjust the version from 82 to 87 in the parameter line if necessary.
If you want to block the firmware update, go to the terminal settings (Terminals - pencil) and check the "Block firmware update" box. In this case, the latest functions and enhancements will not apply to the terminal until it is updated to the latest current version.
¶ 2.5 View transactions for your terminals (menu Reports - Transactions)
The following data is output:
- Transaction status in the form of an icon. If you hover your mouse over the icon, a tooltip will appear. There can be 6 statuses in total:
- A successful withdrawal transaction followed by the release of goods;
- Successful withdrawal transaction without issuing goods (card without hand with cube);
- A successful withdrawal transaction for which a refund subsequently occurred,
- Failed withdrawal transaction;
- Successful refund to the card;
- Unsuccessful card refund.
- The date and time of the transaction;
- ID of the terminal where the transaction took place;
- Transaction amount;
- Card number (last 4 digits). When paying with a smartphone, this number may not match the number on the card, because when you link the card to your smartphone, a virtual card with its own number is created. It can be viewed (for iPhone) in the Wallet app by selecting the card, then pressing the three dots in the top right corner and looking at the device account number, which will show the same 4 digits of the card as on the portal;
- Transaction duration. Indicates how many seconds the buyer waited for the transaction result (depends on GSM connection quality);
- Transaction details (i icon on the right). When you hover the mouse cursor over the transaction details are displayed, which the cardholder can send to his/her bank to sort out if there is something wrong with the transaction. Decoding of ResponseCode values:
- 0 - successful transaction;
- 116 - no money on the card;
- 120 - no money on the card or other error: the card is blocked, low limit of pinless transactions. If such an error occurs on all cards (at least 5 different cards, more than 10% of unsuccessful transactions), you should contact support@vendista.com. If it is a single case, you should contact the bank that issued the card and inform it of the RRN and time of the transaction;
- 999 - TID is not bound to the terminal, or the bank host is unavailable, or other server error.
- 995 - selling for bonuses
- 996 - the bank did not respond to the request
- 997 - the bank is not available
- 998 - TID is not linked or it is from another processor
You can sort the table by any column by clicking on the up or down arrow below the column name. Alternatively, you can use the filter by Period and Terminal Number. You can also enter any text in the "Search by table" field (for example, the last 4 digits of the card number), and the table will be filtered by the entered text (all columns will be searched).
¶ 2.6 Cancel the transaction (menu Reports - Transactions - X)
To make a refund, click the "X" icon to the right of the transaction in the "Actions" column. Refunds can be made up to the close of the shift within the current day. Please note that refunds on transactions from previous days (e.g. "yesterday", "the day before", etc.) are not available.
¶ 2.7 View terminal logs (menu Reports - Terminal Logs)
Before generating a log report, you must fill in the terminal ID. And then click Apply. Other filters are not required, but it is desirable to limit the Period, so that the report is generated faster. Decoding of the log lines is in Appendix 2.
¶ 2.11. Communication at the time of delivery of goods
You can display the inscription on the terminal screen as follows:
- Go to the "Terminals" menu;
- Click the pencil next to the desired terminal to change its settings;
- Fill in the "Message" field when issuing goods. For example, if you want the terminal to say: "Enjoy" after payment, you should enter this phrase like this: {n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n}Please enjoy!
- In the Message Timeout (in seconds) field, enter the desired value, for example 120 seconds.
The message must begin and end with the '\n' characters, and the same character must be inserted after each space between words, as shown in the example.
¶ 2.12. Additional terminal settings
Most of the settings from Appendix 1 that can be set on the terminal are also available to change in the terminal settings menu. You can change the settings of the following sections in the Terminals - "pencil" - Advanced tab:
- Bank section - in this section you can adjust the auto-return timeout:
- Terminal auto-return of payment (in seconds);
- MDB section - contains basic settings for interaction between the terminal and the automaton via mdb protocol:
- MDB. Terminal settings (for the dispenser);
- MDB. Start-up credit (in cents);
- MDB. Maximum credit (in cents);
- MDB terminal level;
- Decimal point;
- Always Idle mode;
- Forcing a cashless sales session to end;
- Disable transmission (listening only);
- MDB. Timeouts - settings are manually adjusted in the parameter strings:
- Timeout (in sec) of product selection;
- The timeout (in sec) of card presentation;
- Time (in sec) after which to report 'Not working' if Reader/Coin/Validator Disabled;
- MDB. Reboot the bus if after X seconds after Reset the dispenser does not send Enable;
- MDB. Terminal Address (Peripheral Address);
- MDB. Maximum session duration;
- MDB. Commodity price conversion factor;
- Double-click when selecting an item;
- MDB. Automator error bypass - values are selected from a drop-down list:
- Don't wait for Ack on MDB packages;
- Ignore MDB errors;
- Switch to Enable immediately on reboot;
- Don't expect a Vend.Complete machine;
- Respond immediately to the machine's requests;
- Do not display an error if the dispenser is in the Reset state for a long time;
- MDB. Listening settings - required for listening to the coin and billfold:
- Guess cash sales by coin and bill packets;
- Scan coin/bill balances (for collection and 3-in-1);
- Timeout of cash sale fixation, waiting for change (in milliseconds);
- MDB. Discounts are an alternative method of rewarding customers with Bonuses:
- Percentage discount;
- Penny discount;
- Demo mode (needed for tests before linking the terminal to the bank);
- Section Other - settings are switched by on/off buttons or selected from the drop-down list:
- Basic Mode;
- Preferred GSM operator;
- Set the direction of the item selection arrow;
- Set the color of the terminal screen;
- Currency;
- Turn the LCD screen upside down;
- Turn off the terminal screen and ignore screen tapping;
- Enable the use of the battery;
- External pin settings (pin 10 on the connector) - needed to control an external device connected to the terminal in Mdb/Pulse modes:
- The value of the pin at startup;
- Trigger;
- Optic sensor;
- Pin inversion hold timeout (in seconds).
After changing all necessary settings, you must send them to the terminal using the Send settings to terminal button. The settings will be sent provided that the terminal is online and there is no contradiction between the values of the applied settings parameters, otherwise the portal will display an error in the dialog box.
¶ 2.13. Using templates
In the terminal settings section (Terminals - "pencil" - Advanced tab), as in the section for sending commands (Terminals - "airplane"), you can save and send a settings template to the terminal by clicking on the corresponding buttons at the bottom of the tab settings section:
- Configure the terminal by template - in this case you will be passed to the page of sending commands to select/add a template;
- Save settings to template - you will be passed to the page of adding a template, where you should select the terminal to record the template settings and enter its name.
¶ Appendix 1. List of commands to the terminal and their parameters
|
№ |
Command name |
Number of parameter |
Command parameters |
|
1 |
Update firmware |
0 |
- |
|
2 |
Reboot the terminal |
0 |
- |
|
3 |
MDB. Starting amount |
1 |
The credit amount (in cents) that the terminal transfers to the machine after the command Press to pay by card |
|
4 |
MDB. Maximum amount |
1 |
Credit amount (in cents), more than which the terminal will not accept payment |
|
5 |
Basic operation mode |
1 |
0 - Connection to the dispenser via MDB protocol 1 - Connection to external controller via UART (Slave) 2 - Connection to the dispenser via Pulse protocol 3 - Direct control of the vending machine mechanisms with 3 product selection buttons For this mode, 3 external buttons and 3 external relays are connected to the terminal. When the button is pressed, the card is pressed and, if the payment is successful, the relay is activated. Matching terminal pins: Button 1 - pin 5 -> Relay 1 - pin 4 Button 2 - pin 8 -> Relay 2 - pin 7 Button 3 - pin 9 -> Relay 3 - pin 10
|
|
6 |
Set screen color |
1 |
1 - Black, output rssi GSM columns 2 - Green, output rssi GSM by columns 10 - Black, rssi GSM output by number |
|
7 |
Timeout of auto-return of payment in case of unsuccessful goods issue |
1 |
Maximum time (in seconds) between payment acceptance and product delivery. If the goods are not dispensed within this time - return the payment amount to the card. 0 - do not return |
|
8 |
MDB. Terminal Settings - Reader Config Data (01H) |
3 |
Parameter 1: Reader Feature Level Parameter 2: Scale Factor Parameter 3: Decimal places |
|
9 |
MDB. Always Idle mode |
1 |
1 - Enable Always Idle mode (requires Reader Level = 3) 0 - Off (requires Reader Level <= 2) |
|
10 |
Flip the LCD screen |
1 |
2 - turn over 0 - do not turn (reboot required) |
|
11 |
MDB. Listening settings |
3 |
Parameter 1: Guess cash sales by coin and bill packets: 0 - don't guess 1 - guess Only makes sense if the machine does not send CashSale. Parameter 2: Timeout of cash sale commit, waiting for change (in milliseconds). Default is 60000. Only makes sense if the machine does not send CashSale and does not block the billfolder for cash sales. Parameter 3: Scanning level: 0 - do not scan 1 - send to the server the packages of the billfolder and coin-operator, necessary for the formation of EVA DTS (to calculate collections and the balance of money in the machine) 2 - send to the server all packets except polls with empty response and failed packets. 3 - send to the server all packets except for failed packets 4 - send all packets to the server |
|
12 |
Forcibly terminate a cashless sales session by MDB (send 0x04) |
1 |
1 - End forcibly 0 - Do not complete Required for "peculiar" automata like E-Vend, which cannot end the session themselves |
|
13 |
MDB address of the terminal (Peripheral Address) |
1 |
High 5 bits Peripheral Address 2 - 0x10 (Cashless Device #1) 12 - 0x60 (Cashless Device #2) (reboot required) |
|
14 |
Preferred GSM operator. The SIM card will first try to connect to this operator |
1 |
0 - No preference |
|
15 |
Turn off the terminal screen and ignore screen tap (necessary to temporarily stop accepting payments) |
1 |
1 - Turn off the screen 0 - Enable |
|
16 |
Switch to the QC test mode (the terminal will assume that it has just been released and is in production). |
1 |
0 - Switch to test mode (reboot required) To remove the terminal from the test mode, connect the terminal to the dispenser, press the screen and bring the card (in any sequence). |
|
17 |
MDB. Disable transmission The terminal will only listen to the bus, nothing will be transmitted. Required for operation in telemetry mode) |
1 |
1 - Disable MDB transmission 0 - Enable |
|
18 |
Enable fixed payment acceptance mode |
1 |
1 - Enable mode. When pressing the screen, the terminal will always accept a fixed amount = Start credit. It will stop working on MDB. Only power supply is required to operate in this mode (automat/master is not needed) 0 - Disable mode (reboot required) |
|
19 |
Battery settings |
3 |
Parameter 1: Use the battery: 1 - Turn on the battery. The terminal will run on battery power when the power is turned off 0 - Disable. If the power is disconnected, the terminal will immediately shut down. Parameter 2: Lock the transition to the Service menu: 1 - Lock 0 - Do not block By default, when disconnecting external power and operating from the battery, pressing in the lower left corner of the screen will bring up the Service Menu. This function can be disabled by sending 1 to Parameter 2. Option 3: Block rebooting/shutdown when the screen is repeatedly tapped: 1 - Lock 0 - Do not block By default, if you tap the screen, the mobile computer will turn off (if powered by battery) or reboot. This function can be disabled by sending 1 to Parameter 3. Reboot required |
|
20 |
Transfer the amount |
1 |
The amount of the loan is in cents. The terminal will authorize the sale of goods for the amount not exceeding the given credit without presenting a card. Upon receiving the command, it will start the session immediately and ask the buyer to select the item. If the credit amount is insufficient - will ask to pay the full amount from the card. The transferred credit will remain in the terminal until it is fully spent or until the terminal is restarted. When receiving this command again, the previous credit will be overwritten by the new one Important! Commission for the sale (with the help of the command) by the bank acquirer is charged, the check on the sale goes to the online cash desk. |
|
21 |
Set the direction of the product selection arrow (where, relative to the terminal, the buttons of the dispenser are physically located) |
1 |
0 - down 1 - from top 2 - on the right 3 - left 10 - do not show the arrow 11 - show cashless payment icon instead of arrow icon 12 - show selection animation |
|
22 |
MDB. Maximum session duration |
1 |
End the session if the automaton does not end it after X seconds (0 - disable the function) |
|
23 |
Amount settings in increments (Pulse, GiftMode - tips, donations) |
5 |
Parameter 1: Starting amount / default amount (in usd) Parameter 2: Minimum amount (in usd) Parameter 3: Maximum amount (in usd). This amount must not be greater than the Maximum Credit (see command 4) Parameter 4: Amount step (in usd), how much the amount will increase/decrease by pressing LCD "+" "-" Parameter 5 (string): arbitrary text displayed at the top of LCD after the caption "Attach card". For example, "for tip payment". String format: utf8 Read more: Tips / donations Reboot required |
|
24 |
Display QR code on LCD |
3 |
Parameter 1: display duration (in seconds). Maximum 256 Parameter 6 (string): QR code Parameter 7 (string): text above the QR code (e.g.: receipt) |
|
25 |
Request the current terminal settings. The answer can then be seen in the logs |
0 |
- |
|
26 |
MDB. Coefficient of conversion of the price of goods Needed for machines that send the price incorrectly. The price for card withdrawal is calculated as: price from VMC * Coefficient / 100 |
1 |
Parameter 1: Conversion factor: 100 - don't count 10 - reduce by a factor of 10 1000 - increase by a factor of 10 |
|
27 |
MDB. Double-click when selecting an item (for older machines) |
1 |
0 - Disable 1 - Enable Needed for machines that do not support "Credit Withholding" (the session is canceled automatically before the customer has time to bring the card and make payment) If enabled, then after selecting the goods, the terminal itself immediately cancels the session and withdraws money from the card as "advance payment". Then it asks the buyer to select the goods again and immediately responds to the machine - dispense, in order to have time before the session is closed by the machine |
|
28 |
MDB. Bypassing machine errors. It is necessary if the dispenser controller has errors in MDB protocol implementation and there is no possibility to correct them (no communication with dispenser programmers). |
1 |
0 - Do not use 1 - Don't wait for Ack on MDB packages 2 - Ignore MDB errors, the terminal will always display the "Touch to pay by card" screen, even if there is no connection with the machine or the connection is incorrect (relevant, for example, for LEI307A). 4 - Switch to Enable immediately at reboot. Needed for machines that incorrectly process the JustReset packet (bus reboot) 8 - Do not wait for Vend.Complete from the machine, go straight to Enable 16 - Respond immediately to requests of the machine (do not wait for Poll) 32 - Do not display an error if the dispenser is in Reset state for a long time 64 - Lock the terminal when accepting Coins/Coupons If you want to enable several options at once, the parameter values should be added together. For example, do not wait for Ack and ignore errors MDB = 1 + 2 = 3 |
|
29 |
MDB. Timeouts |
3 |
Parameter 1: Time (in sec) after which to report to the server the error "Not working" if the dispenser does not switch the terminal to the working mode (Reader Disabled). The same parameter is used to send the event "Coin/coupon acceptor not working" Parameter 2: Timeout (in sec) for customer's product selection Parameter 3: Timeout (in sec) of presenting the card for payment by the buyer |
|
31 |
MDB. Reboot the bus, if after X seconds after Reset the automaton does not send Enable |
1 |
Reset timeout (in seconds). 0 = Disable function The function is necessary for old and peculiar automata, which periodically restart and turn off the terminal, and then "forget" to turn it on |
|
32 |
Accept payment from card |
1 |
The amount of the payment is in cents. Important: The amount must be less than the Startup Loan adjustment. Important: The "Enable fixed payment acceptance mode" setting must be activated for correct operation. |
|
37 |
Send extended logs to the server. Do not use it for more than 24 hours. Otherwise, SIM card traffic may be exhausted and the subscription fee may increase |
1 |
Bitmask of log views: 0 - do not send. 1 - change of states. 2 - MDB/Slave packets, 4 - NFC To combine log types - add up the values |
|
38 |
External pin settings (pin 10 on the connector). Used to control an external device (relay, motor, ice, etc.) |
4 |
Parameter 1. Pin value at startup. 0 = Off, 1 = On. Immediately after sending the command, the pin value will be set to this value. And it will be the same when the terminal is restarted. Parameter 2. Trigger for pin inversion. 0 = Do not use, 1 = Vend Request, 2 = Transaction approved, 4 = Goods dispensed, 8 = Coupon inserted. For a combination of triggers - add up the values of Parameter 3. Pin inversion hold timeout (in seconds). After expiration - the start value will be set. Accuracy: +0.2 / - 1.0 seconds Parameter 4: Use opto-sensor. 0 = Do not use 1 - When the level on pin 5 is changed, the inversion of pin 10 is canceled (if Main Mode = 3 (Three Buttons), the inversion (motor stops) of the pin that was previously selected by the button is canceled). 2 - Block Vend Approve until the level on the opto-sensor changes (no drink is dispensed until the glass is set). 3 - block QR payment at low level on pin 5 4 - when the level on the 5th pin changes, go to the initial state (waiting for the start of the selling session) 5 - For "Three Buttons" mode, if all 3 pins on the buttons are activated. Stop the motor if the level on all 3 buttons has changed (all 3 pins of the buttons must be connected simultaneously to the opto-sensor of the goods dispenser). 6 - When changing the level on pin 6, if Main Mode = 3 (Three Buttons), the inversion is canceled (motor stops) of the pin that was previously selected by the button 7 - Payment blocking at high level of pin 5 (inhibit pulse) 8 - Inhibit payment when pin 5 is low (inhibit pulse) Output voltage at pin 10: 4.4V Examples of Uses:
Send the command with parameters 1 - 0 - 0 - 0 - 0. The relay will always be enabled by default. To reset, send a command with parameters 0 - 0 - 0 - 0 - 0. The relay will turn off. Then: 1 - 0 - 0 - 0. It will turn on.
|
|
39 |
Setting the price by command from the server ( (for Jofemar dispensers) |
5 |
Parameter 1. Price of goods Parameter 2. Price list number (for example: 1-cash, 2-cash for Jofemar machine). Parameter 3. Payment device: 0 - cash (CA) 1 - non-cash payment 1 (DA) 2 - cashless payment 2 (DB) 3 - payment via modem (GW) 4 - payment in tokens (TA) Parameter 4. Item number (Maximum 6 characters) Parameter 5. Product name (If the line is empty, the name does not change, maximum 20 characters) |
|
40 |
Delivery of goods by command from the server (for Jofemar machines) In order for the command to work, the command 52 (MDB GATEWAY) from this table must be sent to the terminal |
3 |
Parameter 1. Item number Parameter 2. Sugar level (0-without....255-maximum sugar) Parameter 3. Dispensing of the glass: 0 - with cup dispensing and without lid dispensing 1 - without dispensing cup and lid 2 - with cup and lid dispensing 3 - without cup dispensing and with lid dispensing) |
|
41 |
MDB. Restart session after Vend.Failure |
1 |
If the machine has sent Vend.Failure, try to start the next session again and dispense the goods (at the expense of the credit withdrawn from the card in the current session). Relevant for Saeco Phedra 0 - do not restart 1 - restart |
|
42 |
Update Bootloader |
0 |
Update the firmware loader on the terminal. The firmware itself is updated at the same time. This is necessary if the terminal "forgets" after rebooting the new settings that appeared in version 84. After starting the update, the terminal will display the message "update programm". |
|
43 |
MDB. Pseudo AlwaysIdle mode |
1 |
For machines that do not support AlwaysIdle. 0 - Off 1 - Pseudo Always Idle. The terminal will always display "Select goods", you do not need to press the screen to start the session. Important! This mode on most machines will make it impossible to sell for cash. 2 - The terminal will always ask you to attach a card. It debits the amount of the Start credit in advance. Then the customer selects a product. The terminal immediately confirms the successful payment to the machine, and returns the change to the card after the goods are dispensed. Relevant for machines that do not support Reservation Time setting |
|
44 |
MDB. Discounts |
3 |
Parameter 1. Discount in percent. The price of the product will be reduced by the specified % Parameter 2. Discount in cents. The price of the product will be reduced by the given amount (in cents). Discounts in % and in cents add up Parameter 3. Demo mode. In this mode no connection to the bank is required. The card will be read as usual, but the request to the bank will not be sent, the terminal will consider it approved and the money withdrawn 1 - enable demo mode 0 - off |
|
46 |
Prices for Pulse / 3-button dispenser |
6 |
Prices for buttons (up to 6) in cents. If = 0, then there is no product for the corresponding button. You can't skip buttons (1000, 2000, 0, 2000, 0, 0, 0 - you can't. 1000, 2000, 2000, 0, 0, 0 - you can). Read more: Instructions for direct control of automatic machines.docx |
|
47 |
Price Selection and Pulse settings |
3 |
Vendista terminal allows to receive signals from external buttons and directly control the mechanisms of the vending machine. It is also possible to work as a payment device with Pulse interface. Read more: Instructions for direct control of automatic machines.docx |
|
48 |
uart port speed |
1 |
Speed of uart port for slave in baud rate The default is 115200 |
|
49 |
Processing server |
1 |
Determines through which processing server the terminal will make payments 0 - WFP 1 - Positron 2 - Inpas 3 - PayPro 4 - Caspi 6 - Evotor A reboot is required. |
|
50 |
Display text on the terminal screen |
2 |
Parameter 1. Period of text display (in seconds) String parameter 1. Text in utf8. Must start with "\n" (automatically converted to 1 line feed character) and end with "\n", use "\n" for line feeds |
|
51 |
Reset settings to factory defaults |
0 |
Resets all terminal settings to factory defaults |
|
52 |
MDB GATEWAY (for Jofemar dispensers) |
1 |
0 - Disable 1 - Enable |
|
53 |
MDB. Barcode Scanner |
1 |
0 - Disable 1 - Enable |
|
54 |
Price Selection Settings and Pulse + DenominationSniff Read more: |
7 |
Parameter 1. Price selection 1 - Price (and product) selection by external buttons (up to 3) 2 - Selection by buttons on the terminal screen (up to 3) 3 - Selection by 2 external buttons Forward / Backward. 4 - Selection by 2 buttons on the terminal screen: Forward / Backward. 5 - Cyclic override of the 1st external button (pin 5) 6 - Selection by 2 external buttons: - X usd / + X usd. 7 - Selection by 2 buttons on the terminal screen: - X usd / + X usd. Parameter 2. Pulse mode (for pulse dispensers) 0 - off 1 - fast speed (50 ms + 50 ms) 2 - slow speed (100 ms + 300 ms) Parameter 3. Denomination Pulse Denomination coefficient for the terminal (how many cents correspond to one impulse) Parameter 4. Denomination Pulse Sniffer Bus 1 Denomination factor for coin/coupon acceptor connected to channel 1 (pin 6, 8, 9 depending on Wiring Diagram) 0 - do not use Parameter 5. Timeout for registration of cash sale (sec) How many seconds to wait before registering a cash sale The default is 15 Parameter 6. (string) Denomination Pulse Sniffer Bus 2. Denomination factor for coin/coupon acceptor connected to channel 2 (pin 6, 8, 9 depending on the Wiring Diagram) 0 - do not use Parameter 7 (string) Wiring diagram The default is 0 More details: Instruction for controlling automatic machine + Pulse (wiring diagrams).docx |
|
55 |
NFC. Transaction settings |
1 |
Parameter 1. Transaction currency 398 = Kazakh tenge 417 = Kyrgyz som 0051 = Armenian dram Parameter 2. Country code according to ISO-3166-1 398 = Kazakh tenge 417 = Kyrgyz som 0051 = Armenian dram |
|
59 |
Text in Pulse |
2 |
Parameter 1: Line code 0 = message on inhibit or power off, 1-6 = for button signature Parameter 2: Message 0 - max. 35 characters, may contain a line break character \n 1-6 - max. 15 characters |
|
60 |
Contactless payment modes |
4 |
Parameter 1: NFC. 0 = Disable, 1 = Enable Parameter 2: QR. 0 = Disable, 1 = Enable Parameter 3: TuganPay. 0 = Disable, 1 = Enable Parameter 4: NFC tag. 0 = Disable, 1 = Enable |
…
¶ Appendix 2. Transcript of terminal logs
The yellow color of the logs means that a packet has been sent from the server to the terminal.
Green is an exchange with the bank.
Blue - exchange with an online cashier system.
The other colors are the packet from the terminal to the server.
|
Type / Subtype / Description of logs |
Significance |
|
Auth |
Successful authorization, the firmware version number of the terminal is displayed |
|
GSM logPart 4, 33 |
Log AT commands sim800 in Request - Response format |
|
Event - ConnectServer |
Successful connection to the server, the cellular operator and signal strength in sim800 terminology are displayed. |
|
Event - CashlessFail |
Unsuccessful sale for cash with indication of the reason for failure |
|
Event - Reset |
Rebooting the terminal with the reason |
|
Event - PowerOn |
Switching on the external power supply with an indication of its voltage |
|
Event - PowerOff |
Switching off the external power supply |
|
MDBPacketTx |
Packet sent from the terminal to the dispenser in the format <Packet length> : <Packet in hex + ChkByte> |
|
MDBPacketRx |
Packet sent from the dispenser to the terminal format <Packet length> : <Packet in hex> |
|
SlaveMode - SlaveModeTx |
Packet (in hex) transmitted from the terminal to the Master |
|
SlaveMode - SlaveModeRx |
Packet (in hex) received by the terminal from Master |
|
PayRequest |
Payment (or refund) authorization request sent from the terminal to the Vendista server |
|
Bank |
Payment authorization request sent from the Vendista server to the bank server |
|
BankAnswer |
Bank response with the result of payment authorization |
|
PayRequest (yellow) |
Vendista server response to the terminal with the result of payment authorization |
|
NFC - PayDelay |
Time (in seconds) between sending a PayRequest and receiving a response to it |
|
VendReport - SuccessCashless |
ItemPrice = item price in cents, itemId = button number of the machine (item number). |
|
VendReport - SuccessCash |
ItemPrice = item price in cents, itemId = button number of the machine (item number). |
|
CashEvent - Credit, Validator |
Accepting a bill of exchange. val - denomination of the banknote in cents |
|
CashEvent - Credit, Coin |
Acceptance of coin. val - coin face value in cents. If negative - giving change |
|
Error - SendAPDU |
Unsuccessful packet exchange with the card (usually occurs when the card is removed prematurely) |
|
Error - ProcessRecv |
Server connection failure (usually due to cellular operator) |
|
ExternalCredit |
External credit credited (via a command from the portal) |
|
ShowQr |
QR code displayed |
|
SendCurrentSettings |
The current terminal settings are requested |
|
CurrentSettings |
Current terminal settings |
|
GpsLoc |
Approximate coordinates of the terminal (by cell towers) |
|
WriteFlashStart/Continue/Finish |
Updating the firmware of the terminal |
|
Kassa |
Sending a check for to virtual cash register |
|
KassaAnswer |
Response of the cash register |
|
ExternalServer |
Sending a package to a partner server |
|
ExternalServerAnswer |
Partner Server Response |
|
Reboot |
Reboot command to the terminal |
|
Settings |
Sending the setting to the terminal |
|
Ping |
Terminal ping (in milliseconds) |
|
Log-General-SelfTestResult |
Request for registration of the newly manufactured terminal. The presence of such an entry in the logs indicates the sending of a command on the portal "Transfer to the OTK testing mode". The terminal will not work normally in this mode. To take it out of this mode it is necessary to connect it to MDB, bring the card and touch the screen |
|
Ack |
Confirmation of receiving a command from the server by the terminal |
|
CashSalePriceError |
The machine sent a CashSale package via MDB, in which the price is higher than the maximum price. In Val - sent price in cents |
|
Event - Coin Disabled, No Packets From Payment Device |
Coin receiver is switched off, no packets from the payment device. Means that information about denominations, on deposited coins, is not received from the machine. |
|
Event - ValidatorDisabled, NoPacketsFromPaymentDevice |
The bill acceptor is switched off, there are no packets from the payment device. It means that information about denominations, on deposited banknotes, is not received from the machine. |
MDB_State decoding:
- MDBState_Reset - 1;
- MDBState_ResetNeeded - 2;
- MDBState_SettingsSendNeeded - 3;
- MDBState_SettingsSent - 4;
- MDBState_Disable - 5;
- MDBState_Enable - 6;
- MDBState_SessionStartNeeded - 7;
- MDBState_SessionStarted - 8;
- MDBState_VendRequest - 9;
- MDBState_PayInProgress - 10;
- MDBState_VendApproveNeeded - 11;
- MDBState_VendDenyNeeded - 12;
- MDBState_VendApproved - 13;
- MDBState_VendDenyed - 14;
- MDBState_SessionEndNeeded - 15;
- MDBState_SessionCancelNeeded - 16;
- MDBState_SessionCanceled - 17;
- MDBState_ExpansionSent - 18.
EN
/home
Visual Editor
41979 chars, 7398 words