Transaction Manager: Updating the Integration Service (SSL) Certificate

Product(s): Transaction Manager, Integration Service

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.

NOTE: The Integration Services is not compatible with a Mac.

To get right to the point, you can quickly update the certificate using our tool and skip all of the details below.

IMPORTANT: This tool will not work if you are running on a third-party Terminal Server / Remote Desktop service. Contact your third-party Information Technology (IT) team and have them follow the manual steps, below, while logged into the server as a LOCAL ADMINISTRATOR.

🛑 Note: Click the arrows below to expand each section.

Update Certificate Quickly via the Update Tool

From the Foundry primary navigation menu, select Account Management > Downloads or download the tool directly here.

NOTE: Once downloaded, navigate to the folder it downloaded to, then right-click and select Run as Administrator to launch the tool.

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

Locate the UpdateCert.exe (typically in Downloads) file as shown below, right-click, then Run as Administrator.

You will receive a text file similar to the one shown, below. Press any key to move forward with the update as instructed.

The certificate update and exchange occur in the background. When completed, your default browser will open and display the current version of YOUR local Integration Service.

Once your local version displays, the certificate update process has completed. Close/exit any instructions or browser pages from the update process. You are now ready to process within Transaction Manager as normal.

NOTE: If you are still unable to import/export after completing the above steps, you may just need to stop, start, or restart the Integration Service due to permissions or system limitations. To do this, perform the steps, below.

Launch Microsoft Services Manager by going into your Windows Start menu and type "services" in the Search box. As you type, Services will appear. Click it to open it.

From the Services window. scroll down and locate the service, entitled Transaction Manager Integration Service on your list. Complete step 1 or step 2, below, based on the status of your Transaction Manager Integration Service:

Is the Transaction Manager Integration Service running? Verify this by looking in the Status column (reference 1)? If it is not running, right-click on it and select Start, or you can click Start in the upper-left corner of the Service window (reference 2). Both will do the same. After starting the Transaction Manager Integration Service, you are now ready to process within Transaction Manager as normal.

2. Is the Transaction Manager Integration Service running? Verify this by looking in the Status column (reference 1). If it is running, right-click on it, then select Stop, or you can click Stop in the upper-left of the Service window (reference 2). Both will do the same.

Now that the Transaction Manager Integration Service is not running, right-click on it and select Start, or you can click on Start in the upper left of the Service window (reference 2). Both will do the same. After starting the Transaction Manager Integration Service. you are now ready to process within Transaction Manager as normal.

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

CAUTION: Only follow/start the steps, below, for manually updating the certificate if you were not able to use the steps above utilizing the tool.

Manual Certificate Update Steps

STEP 1: Download Certificate
Login to Transaction Manager and select Integration Settings from the primary navigation menu.

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

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 web browser, the file will download with a .p12 extension. You must rename the file to .pfx to proceed with the steps below.

CAUTION: 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 click Start from your Windows menu and type "Services". The Start menu will identify what you are typing and highlight it in your menu.

Locate the service, entitled 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 and 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, right-click on the file, go to Properties, then look under the General tab. If you see an 'Unblock' checkbox that is unchecked, 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. Return to the Services screen (opened under Step 2), then 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, 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 must 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. Verify with either your IT or by using our article to determine if this is a step you need to take.

rev: 9/6/23