TSYS

Terminal Installation

Please Note

Make sure there is a “Temp” folder in c:\SuperSalon\ssproject. Tsys uses that folder to store information like signature etc, and if the folder is not there, it will get stuck.

Installing the Hardware

1. Open the PAX Terminal’s back and install the main cord to it (the one with one input and three outputs).

2. Plug in the electrical power adapter to the main cord.

3. Plug an Ethernet cable into the main cord’s red output.

4. Plug the other end of the cable directly into a router or modem. The router must have DHCP service on.

Obtain the CCT IP Address And Set It Statically – REQUIRED

1. Access the menu by pressing the menu button or Func+1.

2. Enter password (Default: 7724629), and press enter.

3. From Main Menu, scroll down and select Communication → Enter the password again (7724629) → LAN Parameters → LAN Type.

   • The CCT will request that you input the password again, after entering the communications menu – this is expected.

4. From the two options “1 Dynamic” and “2 Static”, select “2 Static”.

5. Under IP Address on the CCT, have the user press the green button to confirm the changes made.

6. Now have them press the red button a few times to get back to the splash screen.

7. REQUIRED: Send an email to TSYS to notify them of the newly configured static IP address. You must include the following:

a) Merchant ID – just the last 9 digits – The MID can be found on a sticker on the terminal itself just ask the staff to locate it and read it to you.

b) The IP Address

c) Subnet

d) Gateway

e) DNS

f) Select Connectivity Issue from the dropdown options

All of the other fields are required, but if you are unable to provide one or more of the requested pieces of information, you can type NA into the field.

Alternative Instructions for PX5 and PX7 Devices

The preliminary configuration is the same as the S300, and this is also the machine that should be selected under Software Settings > Hardware > Payment Processor > TSYS.

However, the menu options are different for these newer devices, so retrieving the IP address is achieved by following these steps:

1. Press and hold the ENTER key and Key 1 together to go to the main menu.

2. Enter the password. (same as usual)

3. Select 6. “Communication“

4. Enter the password.

5. Tap on the right arrow

6. Select “Lan Parameters Option“

7. IP Address

8. Back button twice to Lan Parameters

9. LAN Type – make this static

Open Windows Firewall & Router Ports

Follow this guide to learn how to open ports in the Windows firewall. You will need to create inbound and outbound rules for TCP and UDP for the listed ports:

• TSYS TCP IN – 443 ,5003, 550, 8580, 10009, 8080, 3306, 8001, 80

• TSYS UDP IN – 443 ,5003, 550, 8580, 10009, 8080, 3306, 8001, 80

• TSYS TCP OUT – 443 ,5003, 550, 8580, 10009, 8080, 3306, 8001, 80

• TSYS UDP OUT – 443 ,5003, 550, 8580, 10009, 8080, 3306, 8001, 80

Configuring SuperSalon to Process with TSYS

Total Confirmation Screen

Some business owners may prefer to have a total payment confirmation screen displayed on the PAX terminal, giving the user the option to accept or decline the total. To enable this, they will need to reach out to TSYS support who can enable it for them through remote configuration and pushing the update to the CCT.

Configure Software Settings

1. On the POS, go to Setup > Software Settings > Hardware > Payment Terminal.

2. Set the Payment Gateway to TSYS.

3. Scroll down to the TSYS section, and enter the IP address you gathered earlier.

4. Leave the remaining fields as they are, save the page, and press f5.

5. Ask the owner what their preferences are on the following software settings

Configure Payment Methods

1. Go to Setup → Payment Methods.

2. Edit existing credit payment options, or create new ones.

IMPORTANT

The following payment types are allowed with TSYS, and the TSYS Map must be set for processing to work. Not all of these payment methods need to be entered as an option, most customers only require (and prefer) Visa, Master Card, American Express, and Discover.

Important Note About Payment Methods

If you want to reuse an existing credit card payment method for the Tsys integration, you need to edit it, assign and save the correct Tsys Map column for the type of credit card payment you want to accept. All the required credit card payment methods for Tsys Integration must be configured on the POS. Otherwise, the system will show an error message on the payment method indicating that there are missing payment methods.

Turn on Employee Tips

Since the TSYS integration asks for tips to keep the design consistent, the POS needs to assign the tip to the employee via the Employee Tips Popup.

To enable employee tip tracking, go to: POS > Software Settings > Sales > Tips > Track Employee Tips.

Disable Legacy Payment Processing Platforms

1. Go to Setup → Payment Methods → Credit Card Processor Setup.

2. Take a quick look through each processing platform tab, making sure that all of the below options are disabled/set to “none”:

• Card Swipe Device

• Credit Card Enabled

• Allow Tips

It’s important that all other processors are disabled, or TSYS processing may not work. Save the page if you made any changes, before continuing to the next one!

Troubleshooting TSYS

Optional TSYS Settings

Disable the electronic signature on the CCT

SuperSalon 6.2.8 included a software setting that allows a user to disable the electronic signature requirement for customers at check out. The setting is located under Setup → Software Settings → Hardware → Payment Processor in the TSYS section.

Disable tip prompt on CCT

SuperSalon 6.2.8 also came with an option to disable the tip prompt for customers at check out. The setting is located under Setup → Software Settings → Hardware → Payment Processor in the TSYS section.

Total payment confirmation screen on PAX

Some business owners may prefer to have a total payment confirmation screen displayed on the PAX terminal, giving the user the option to accept or decline the total. To enable this, they will need to reach out to TSYS support who can enable it for them through remote configuration and pushing the update to the CCT.

Enabling TSYS Logging

To enable logging

Location of the logs after enabled

• C:\SuperSalon\ssproject\temp

Log Naming Format

• Up to 6.2 – POSlog.txt

• 6.3 and up – 6.3 POSlogYYYYMMDD (year, month, date)

Reset PAX s300 to Factory Settings

1. Power cycle S300 device and as device reboots, when “Self-Test” displays on device screen, press and hold down the blue <FUNC> key.

2. Device will display OS application versions

3. Select Menu option or press Green <Enter> key to get to MENU options

4. Enter 4 for Option “Remote Download”

5. Enter 1 for Option “New Download”

6. Enter 1 for Option “TCP”

7. Enter IP address 216.238.144.195 (press 1 and then Alpha key repeatedly to enter the dot symbol) and then press Green <ENTER> key

8. Enter Remote Port 8582 and press Green <ENTER> key

9. For Enable DHCP, enter 1 for Option [Yes]

10. For Terminal ID, enter 30030420 and press Green <ENTER> key.

11. Download will begin and when completed device screen will display “Download 100%” and “Download OK!”

Windows 10 Enterprise Edition (Version 1507) Issues

While the Enterprise versions of Windows tend to be the most advanced, the 1507 iteration of Win 10 turned out to be a glaring exception. In fact, Microsoft stopped sending security updates to this relatively new OS less than two years after its official release. All users of this version are advised to update to the newest and most stable version of Windows 10 at their earliest convenience.

The 1507 iteration has no compatibility with with .Net Framework 4.7 or the newer versions of it. Because of this, the proper configuration of the TSYS integrated card processing platform is nigh impossible. This framework is required for secure encryption and transmission of data, and it is advised that you recommend an upgrade of the operating system to the salon owner before proceeding.

Manual Firmware Updates

WARNING: NEVER perform a firmware update without working directly with a TSYS support representative!

Please follow these instructions to upgrade the firmware:

1. What you will do is power cycle the device and when it says self test press menu.

2. Select Option 4 (Remote Download)

3. Select Option 1 (New Download)

4. Select Option 1 (TCP)

5. Type in Remote IP 184.73.218.146

6. Type in Remote Port 8580

7. Select Enable DHCP Option 1: (Yes)

8. Type in Terminal ID (Input the terminal Serial Number)

A program to troubleshoot connectivity can be downloaded here.

Gaining Access to a Locked Terminal

When an incorrect password is entered into a PAX terminal enough times, the unit will lock down to prevent any further attempts at access. In these instances, Support agents are advised to power cycle the unit, and enter this default password: 7724629 If this does not resolve the issue, it is advised to contact TSYS Priority Support at 1-855-882-0507 for their agents to unlock the device on their end. The following resources will need to be on hand for this call to be successful:

• The client’s MID number

• The legal business name of the account

Terminal Fails to Connect for App Update

The cause of this issue is usually because TSYS shipped the unit with an internal address still set for the config address. To change it, use the password 7724629, and navigate to the following interface on the device: Menu > System Settings > App Management > Configuration. The Server URL should then be set to 40.128.76.74 (Periods can be entered by pressing 1, then Alpha 3 times) in the Configuration menu on the CCT.

Unable to process after initial device set up, or manual database edits

It was recently discovered that information for TSYS that is entered into the SuperSalon database is completely case-sensitive, and may lead to errors and/or problems if entered incorrectly. Below is the procedure to confirm this protocol in the phpMyAdmin console.

1. Log in to phpmyadmin (localhost/phpmysql).

2. Navigate to the _options table.

3. Search for the “tsys_terminal_commtype” field, using the search tab.

4. Verify that the value field is “HTTP” is in all capital letters, not lower case.

TSYS “TAMPERED” Error Message

If a location is receiving this error when trying to run credit card transactions, there is workaround or fix to the issue can be performed by our Support department. Any indication of tampering with the encrypted terminal immediately shuts down the unit permanently.

Direct clients who receive this error to TSYS Support for a resolution that will most likely involve buying a new terminal.

Terminal Displaying TERM NOT ACTIVATED

If you are working with an end user that is seeing a TERM NOT ACTIVATED message on their credit card terminal, TSYS support provided us with the following as troubleshooting:

1. Access the main menu and enter the terminal password: 7724629

2. Go to Host Settings → Activate.

3. The CCT will display Activation Success, after which you can have the salon staff back out to the main menu again and the issue should be resolved.

4. Make sure the message is gone and that the salon can process credit cards again.

Manually Check if a Payment was Processing on Terminal

F+1 -> Display Transactions -> Find -> Last 4 of the card -> Results: Transaction Details or Transaction doesn’t exist.

TSYS FAQ's

Is Apple Pay available for TSYS Clients?

• Apple Pay is supported but it is not set up by ProPoint, and is instead 100% configured on the processor end. They need to program their terminals to accept it. When active, the staff can chose any of the Credit Card Payment options and Apple Pay counts under that selected option in the closeout.

Can a user perform a transaction using Voice Authorization while processing is down?

• No. Voice Authorization payments are NOT supported by SuperSalon. TSYS users must repair any network issue they may have, or wait for functionality to return if TSYS’ server is down in these cases.

How can a user process a manual transaction?

• When the CCT asks for the user to swipe their card, they can alternatively begin typing their credit card number to start the manual entry process. If this doesn’t work, the business owner will need to contact TSYS to have manual entry enabled by their support team.

Can a salon using TSYS process SVS cards?

• Not exactly. In order to process gift cards, they must use a bar code reader or manual entry (not the CCT!) – SVS processing is a SuperSalon integration in this case, not directly through TSYS!

Is it possible to process debit cards as debit, rather than credit?

• In order for TSYS to process debit cards properly, as opposed to running them as credit cards, the option of doing so can be added to the location’s account. The owner will have to notify TSYS directly to add to this feature.

How does a salon processing with TSYS refund a tip?

• Instances where clients of a salon need a refund on their tip payment require a special refund process to be performed in order for product and service sales to report correctly.The solution involves creating two new tickets, and the direct quote from James Rowe who formulated the solution is as follows:

1. The customer would need to present or you would need card number.

2. Then you would run two sales. One for the refund amount and refund the cards

3. Then run second sale offset the first one and pay with cash.

This would result in an inflation of cash and deflation on credit. You must have 2 transactions for this method. After review, it was found that the solution was in fact effective, as long as the following caveats in both transactions were observed:

• The first transaction should have the refund go back to the customer, making the salon at negative cash value in Service.

• The second transaction would have to be for cash, and it would have to be a house sale paid by the stylist in order offset customer records.

• The stylist tip would then need to be manually edited to reflect the change.