How to integrate TSYS with RepairDesk?

TSYS provides you the benefit of cloud based payment processing which is reliable as well as efficient. RepairDesk allows its users to integrate with TSYS in order to grow their business. To know more about RepairDesk's partnership with TSYS please click here

Setting up TSYS integration is very simple. Let us show you how to do it in seven simple steps!

How to Setup TSYS Integration?


Just follow these steps and you are good to go! 

1. Sign up on TSYS. Once you have created an account, you will be provided with:
a) Merchant Name
b) Merchant Site ID
c) Merchant Key

2. In RepairDesk go to Settings >> Integrations >> TSYS.

  
3. Enter the Merchant Name, Merchant Site ID and Merchant Key on TSYS Payment Gateway Setting page. 

4. Turn on the TSYS Genius device. Enter "0 0 0" (zero-zero-zero) three times, enter TSYS Genius password (9416557) and press the enter button. Note the IP Address. To know more about this step, click Here

5. On the TSYS Payment Gateway Setting page in RepairDesk, enter the Device IP and hit Save

6. Once you have successfully configured, please install root certificates for Firefox, Chroome or Safari so you can process a transaction. To know more about how to install TSYS Genius Root Certificates please click Here

7. You can download certificates for TSYS from here. The same certificate will work for Windows, iOS and Android devices.

And presto! TSYS is integrated with RepairDesk. 

How to setup TSYS Certificates? 


Some clients may face an issue with TSYS Certificate trust settings. To resolve this, we are providing below how to set up trust settings of TSYS Certificates in both Mozilla Firefox and Google Chrome. 

A. Firefox

After you have successfully installed TSYS Cartificate,
1. Head to settings in Mozilla Firefox.
2. Go to Advanced Certificates.
3. Select Authority
4. Open TSYS
5. Edit CA Certificate Trust Settings and select all there check-boxes. 
6. Finally, click on Save.

Now TSYS Certificate would be considered as a trusted certificate and you can run TSYS Integration smoothly on Mozilla Firefox. 





B. Chrome

To set up TSYS Certificates in Google Chrome,

1. Open Google Chrome
2. Head towards Settings
3. Search for Certificates from the search field
4. Click on Manage Certificates
5. Open Trusted Root Certification and see if TSYS is present there. 

If it is not in Trusted Root Certification,
1. Open TSYS Certificate
2. Install the certificate in the local machine and
3. Place the certificate under Trusted Root Certification Authorities
4. Proceed with installation 

Now TSYS Certification would be considered a trusted certificate by Google Chrome.




Troubleshooting

A. Issue with TSYS Root Certificates:
In case if you're unable to see TSYS Certificates under Trusted Root Certifications, check them under Trusted Publishers. Import the certificate here, if it's not already appearing there.  
1. Open TSYS Certificate
2. Install the certificate in the local machine, and
3. Place the certificate under Trusted Publishers.
4. Proceed with installation.



B. Issues with IP:
TSYS works best when IP address for TSYS Genius is set as Static. In case of IP being Dynamic it will keep changing. In that case, you would have to match the IP in RepairDesk TSYS Integration and IP showing up on TSYS Genius Terminal.

Perform these steps to make IP static on TSYS Genius Device:
1. Make sure you have your IP address, subnet mask, Gateway and DNS1 from your
network administrator for the Genius device to connect to your router/switch.
2. On the keypad, hold down 1, 5 and 9 buttons together for two seconds, and then release.
3. Use the keypad to insert the password 166832 and press Enter. In case this password is not working, please contact TSYS Support.
4. On the tabs at the top of the screen, touch Administration and then Communication.
5. From the tabs at the top of the Communications screen, touch Network and then Ethernet.
6. From the Ethernet screen, touch the edit symbol next to Mode.
7. Select staticIP and touch OK.
8. Touch the Pencil symbol next to IP Address and use the keypad to enter the IP address
assigned to the Genius CED and then touch OK.
9. Configure your subnet mask, Gateway and DNS settings.
10. Touch Apply.

For more information, please click Here.

C. OS Version:
Please make sure that OS and Application Versions for TSYS Genius are updated
At the moment the latest OS for TSYS is RFS00190 and Application Version is 5.0.8.0




D. TSYS CORS Settings
If the above mentioned steps haven't fixed your TSYS configuration already. then it's probably an issue with TSYS CORS settings. Please contact TSYS support and they will enable CORS settings for you. 


FAQs

Q. How can I contact TSYS Team if I have a problem with my account?
A. (844) 255-0561 is the dedicated phone line for RepairDesk customers calling into TSYS. 

Q. I have to configure TSYS integration again and again. What's the reason?
A. Make sure that TSYS Genius device and RepairDesk are connected to the same internet connection. Also, it is advisable that the device IP should be static so that you don't have to set up configuration each and every time.

Q. How to make a payment after I have successfully integrated TSYS?
A. On RepairDesk POS after hitting on Checkout, select TSYS from the payment methods, select amount and click on Pay Now. The details will go on TSYS Genius device and you will get the following pop-up.




Note: If during payment processing, you want to cancel the transaction, then you can do it by hitting Cancel Transaction.






Approve the transaction, swipe the card and take customer signatures. You will get the following pop-up indicating that your transaction is approved.




Finally click on Confirm on the checkout screen of RepairDesk. If you have forgotten to click on confirm, then you will receive the following pop-up.



You can simply hit Dismiss to close this pop-up.

Note: If the transaction has failed, then you will get the following pop-up






Q. When can I cancel a transaction?
A. If you cancel the amount before swiping the card on TSYS Genius device, no transaction will take place and you can cancel it. 
If you have swiped the card but haven't taken customer signatures then it would still count as a signature but you would be notified that customer signatures were not taken.

Note: You can also reset a transaction before making payment by hitting Reset Genius Terminal button on payment screen which will reset the transaction and you can go through the payment process again to complete the transaction.



Q. What options are available with TSYS?
A. Our integration has been certified for the following
  • Swiped Credit Sale (Genius)
  • Debit Sale (Genius)
  • Void
  • Refund 
  • EMV
  • Line Item Display
  • Discounts
Q. How can I apply for TSYS account? 
A. To know more and apply for a TSYS account, please visit here

Q. Can I take customer signatures?
A. Certainly, you can. 

Q. Can I accept NFC payments such as Google Pay or apple Pay?
A. Certainly, you can. 

Q. Can I use TSYS for payment via Invoices?
A. No. You can use TSYS via POS only. 

Q. How can I process Sale with TSYS Genius Terminal?
A. Processing a sales transaction with TSYS is super easy. Once you've successfully integrated TSYS with RepairDesk, simply:
1. Add an item to basket in RepairDesk and head to Checkout.
2. On TSYS Genius Device accept Terms and Conditions.
3. From Payment Screen in RepairDesk, select TSYS from multiple payment methods.
4. The transaction will appear on TSYS Genius Device.
5. Click on Pay Now on RepairDesk payment screen.
6. Select payment method from TSYS Genius Device.
7. If you're using credit/ debit card, swipe the card through the device.
8. Take customer signatures and click on Accept on device.
9. Payment through TSYS will appear on RepairDesk. Click on confirm to complete transaction.
10. Now if you view invoices, you can see the invoice for the particular transaction you've just made.  

Please see attached GIF for further clarification.




Q. How can I process a Refund via TSYS?
A. Refunding an invoice via TSYS just takes a couple of clicks. In repairDesk,
1. Select an invoice you wish to refund and click on Refund button against it.
2. Items in invoice will be added to basket for refund. Head to checkout.
3. Add the amount which you want to refund to your customer.
4. Finally, click on Confirm to complete refund. 

Please see attached GIF for further clarification. 



Q. How can I approve a job order from customer while using TSYS Integration?

A. To so so please follow these steps:

1. Go to TSYS Integration Settings.
2. Click on Configuration tab.
3. Activate the trigger: "Enable on Ticket"
4. Hit Save button to update settings.



Note: You cannot use TSYS Genius terminal to accept customer signature along customer facing display integration. Also, give title and description under Agreement field; it should not be blank. 

Once signatures are enabled, you can take customer signatures for pre-repair and post-repair device conditions on POS as well as in ticket. 






Clicking on Cancel Request will cancel work approval from customer and you would have to send request again to take customer signatures. If there is already a request on TSYS Terminal, clicking on Reset Terminal will clear that to make way for new request. 



Q. How can I setup multiple TSYS Genius Terminals?
A. To setup multiple TSYS Genius Terminals:
1. Head to Configuration tab under 
TSYS Integration Settings.  
2. Enable the trigger "Multiple Terminals".



3. Click on Save button. 
4. Now go to Multiple Terminals Settings under TSYS Integration Settings
5. Cash Registers which you have already created will be appearing here. Set Device IP for TSYS Genius Terminals against these Registers.
6. Once done, click on Save button to update settings. 




Note: You can setup cash registers in the settings section of Repair Desk by going to Register Settings for Cash Registers under Settings.



Feedback and Knowledge Base