Transaction Manager: InitializePlugInDll Error

Getting an error that includes "InitializePlugInDll"? Or, wondering what a DLL is in general? Read on!

Support avatar
Written by Support
Updated over a week ago

Product: Transaction Manager

What is the Integrations DLL?

A Dynamic Link Library (.dll) is a file that acts as a set of procedures and is needed in order to request, send or translate data passed to and from your ERP and Transaction Manager.

Why is my DLL important & why do I need to update them?

Every ERP supported by TrueCommerce has its own unique DLL file. This DLL holds the rules determined by the ERP and Transaction Manager that must be met in order to successfully pass data. Whenever a new version of a particular ERP comes out, the rules usually change along with it. For this reason, it’s important to let TrueCommerce know of any upgrades or updates from your current ERP version to a newer one. Often these rules have to be updated within the DLL, which requires our team to prepare modifications. ERP updates made before the DLLs have been updated may cause interruptions, errors or even lock you out from passing data until the rules in the DLL match your updated ERP.

Please note that it is very important to always backup your DLL files before you attempt to reinstall/update/modify your Transaction Manager Integration Service.

Common error: InitializePlugInDll

If you receive this error, you can try the steps below to attempt to fix your Integration DLLs. Note: Another common error is "Exception has been thrown by the target of an invocation".

Solution 1 - Restart the Integration Service

You will need Admin Rights to perform this action!

  1. Use the Windows Search to find your Services App

  2. Locate Transaction Manager Integration Service

  3. Use the Restart button on the top left to restart the service

After restarting the Integration Service, go ahead and try again. Most times a restart of the Integration Service can alleviate any issues with a previously working connection.

Solution 2 - Update Your DLLs

The DLLs that your system use will be located in your C:/Program Files (x86)/True Commerce/TmoIntegrationService folder.

If you do not have this folder, please check that you are not using a Terminal Server (i.e. using another application to “remote” into another computer to use Transaction Manager).

If you're not using a Terminal Server and still do not have this folder, you will need to install the Integration Service (instructions at the end of this article).

Step 1 - Backup your DLLs

Navigate to C:/Program Files (x86)/True Commerce/TmoIntegrationService

Locate your DLL and move to a safe place

Always locate your appropriate Tc.Int.Platform.BSPxxxx.dll and back it up to a safe place before updating your DLLs! This ensures you always have a saved DLL to return to for any reason.

Step 2 - Use the DLLs provided in the folder

Some versions of the Integration Service have the latest updated DLLs already inside the folder. If that’s the case, you just need to move them. Locate the subfolder labeled with your ERP: C:/Program Files(x86)/True Commerce/TmoIntegrationService/ErpFolderName

If there is a Setup.exe located in your respective folder, you will want to install that first as an Admin (Note: Not all ERPs require this).

Copy the DLL located in this folder, and paste it into the main TmoIntegrationService folder.

Restart the Integration Service again (provided in Solution 1).

Solution 3 - Enable Permissions

It is possible that your computer is denying Transaction Manager access because the folder that holds the DLLs is set to not allow it to read or write to that folder.

Navigate to C:/Program Files (x86)/ and locate the TrueCommerce folder. Right Click the folder → and select Properties

Select the Security Tab

Provide Full Control permissions to the Everyone user

If the Everyone user is missing - select the Edit button. Select Add on the new popup window. Type Everyone into the box on the bottom. Select Check Names and hit OK.

Check the Full Control checkbox under the Allow column with the Everyone user selected

Solution 4 - Reinstall the Integration Service

Sometimes a clean install is best!

Backup any DLLs you may have!

Stop the Transaction Manager Integration Service in your Services tab

Uninstall the Transaction Manager Integration Service from your Add/Remove Programs

Delete the C:/Program Files (x86)/True Commerce folder

Delete the C:/ProgramData/TrueCommerc folder (this is a hidden folder)

Install the Integration Service following the instructions below.

Installing the Integration Service

If you do not have the Integration Service Installed you will need to have it installed for every computer that uses Transaction Manager:

  1. Navigate to Transaction Manager → Integration Settings → Download Integration Settings

  2. Launch TmoIntegrationServices.exe as an Admin

  3. Follow the prompts of the on-screen installation

rev: 10/19/21

Did this answer your question?