YSoft Payment Machine migration procedure from YSoft SafeQ version 3.6 to 5

Overview

YSoft Payment Machine (= YPM) allows you to perform easy credit recharges. 

There are a few major changes from previous versions.

YSoft Payment Machine is now connected directly to YSoft Payment System instead of YSoft SafeQ server and this connection is automatically negotiated and kept in place the whole time to allow the better monitoring of YSoft Payment Machine. For interconnection has been developed a new communication protocol, which is strongly encrypted with low bandwidth requirements and has many future benefits.

For its proper functioning, YSoft Payment Machine has to be correctly configured. Mainly the communication protocol (the new one for YSoft Payment System), the YSoft Payment System server address (hostname or IP address), and other items as in the previous version (for example currency, enabled notes/coins, etc.) have to be set correctly. Due to direct communication to YSoft Payment System, there is a separate configuration of the YSoft Payment System server address and YSoft SafeQ server IP. Connection to a YSoft SafeQ server is not required.

Migration procedure

If customer needs to reconfigure YSoft Payment Machine from YSoft SafeQ 3.6 to YSoft SafeQ 5 with YSoft Payment System, there are only a few steps required on the YPM side:

  1. Verify that there is no unfinished recharging - migration will erase them

  2. Update the firmware of YSoft Payment Machine to 3.14.0 or newer using utility "Remote configuration tool", this utility is present in the installation package

  3. Reconfigure YSoft Payment Machine to the new communications protocol

  4. Set the YSoft Payment System server address (server hostname and port - default 4197)

  5. Perform the configuration of SPM on the YSoft Payment System server

Network communication

The YSoft Payment System server in its default configuration has these TCP ports dedicated for YSoft Payment Machine connections:

  • 4197 - Management connection over SSL - this port is needs to be set up in the YSoft Payment Machine service menu during the configuration of the YSoft Payment System server address

  • 4199 - Main connection over SSL

  • 4196 and 4198 - Reserved for future use (connections over plain TCP)

Both connections are permanently connected to ensure full YSoft Payment Machine monitoring from the server and quick responses to user login. First the management connection is negotiated and then, if YSoft Payment Machine is authorized to connect to the server, the main connection is established.

images/download/attachments/21969371/SPM.png