Article Link: http://help.truecommerce.com/en/articles/2308337-updating-the-integration-service-ssl-certificate

If you are using the Transaction Manager Integration Service, you may be required to update a certificate that is used to communicate between the TrueCommerce network and your local environment. What is the Integration Service?  Learn more about it here. Please note that the Integration Service is not compatible on a Mac.

To get right to the point. You can quickly update the certificate using our tool and skip all the details below. Note that this tool will not work if you are running on a third party Terminal Server / Remote Desktop service. Please contact your third party IT and have them follow the manual steps below.

How do I know if I am using the Integration Service? Check out the following article to see if you have the Integration Service installed.

Already updated the certificate and still can't get it working? Verify ports are set properly and check out this troubleshooting guide.

Update Certificate Quickly via the Update Tool

Go into the Downloads section of the Account Management Portal as shown below or download the tool directly here.

NOTE: Once downloaded, go to the folder it downloaded to and right-click and "Run as Administrator" to launch the tool.

Once in the Downloads section, locate the "Integration Service Certificate Update" and download it.

Run the tool as an administrator. Once the tool completes it will open your browser. If it was successful, a webpage will load with just the text of the version of the service such as the screenshot below (your version may vary):

If it does not show the version, restart your computer and test your integration. If you still have issues after that, try the manual steps below or contact support.

QUICKBOOKS CUSTOMERS: You may be asked by QuickBooks to re-configure your trust with the TrueCommerce integration. Follow this article if you are prompted by QuickBooks.

Manual Certificate Update Steps

Please note that it is highly recommended to leverage MSEdge, Chrome, or Firefox to follow steps. Do not use Internet Explorer or EDGE as they rename the files upon download.

STEP 1: Download Certificate
Login to Transaction Manager and navigate to the Integration Settings page 

On the Integration Settings page, click the link Download Upgraded Certificate

The prompt will explain instructions on the download. Press OK to download the certificate.

The file TmoIntSvcs.pfx will be downloaded to the computer.  

NOTE: If you are using a Microsoft browser, the file will download with a .p12 extension. You must rename the file to .pfx to proceed with the steps below.

DO NOT ATTEMPT TO OPEN THE CERTIFICATE.  It will ask you for credentials.  Opening is not necessary.  Continue with the steps below.

STEP 2: Stop the Integration Service from Running
Launch the Microsoft Services Manager by going into your Windows start menu and type services. The Windows start menu will identify what you are typing and highlight it in your menu 

Locate the service titled Transaction Manager Integration Service

Right click on the service and select Stop.

Leave this services console open as you move through the remaining steps.

STEP 3: Replace the Certificate
Navigate to the installation path of the Integration Service

NOTE: Default installation path is: C:\Program FIles (x86)\True Commerce\TmoIntegrationService

Place the new TmoIntSvcs.pfx file into the directory. You will be prompted to overwrite the old file, select replace the file in the destination.

If a security prompt presents itself, press Continue to overwrite the file.

NOTE: After replacing the file, be sure to verify the file is not blocked by Windows. To do this, simply right click on the file, go to Properties and look under the General tab. If you see an Unblock checkbox that isn't checked, check it and apply. If the file is not blocked, no Unblock text or checkbox will appear.

STEP 4: Start the service
The last step is to start the service. Go back to the services screen, opened under Step 2, and right click on the Transaction manager Integration Service. Select Start to re-initiate the application.

At this time, your certificate will be up to date.

As always, if you have any questions or problems with this update, please contact our support team directly.

Understanding More about this Certificate

Why do I need to update this certificate? A certificate is what provides a secure connection between the TrueCommerce network and your local environment. To remain secure, certificates occasionally have to be replaced or updated to meet new standards or to renew against expiration.

Do I have to do this? If you are using the Integration Service, you do need to perform this update.

How do I know if my certificate is updated or not? If you are able to integrate between Transaction Manager and your ERP, your certificate is updated. Any attempt to integrate with an expired certificate will prompt you to download the service, which contains the latest certificate.

Not every Transaction Manager customer is using the integration service. So please verify with either your IT, or using our article below, to determine if this is a step you need to take.

Did this answer your question?