Adding the new MD5 support | Kartris User Guide

17.21.4. Adding the new MD5 support

If you are updating an existing Worldpay installation, you will need to do the following.

17.21.4.1. Add the new Worldpay payment DLL

You may need to stop the web site in IIS first to unlock the existing DLL. Then copy the new Worldpay.dll file from the latest Kartris zip (/Kartris/Plugins/Worldpay folder) into your web, overwriting the existing file. Then you can restart the web site in IIS.

17.21.4.2. Add the new setting to your Kartris site

Find the Worldpay.dll.config file in the same folder as the Worldpay.dll you just changed. Open this in notepad for editing and add this new section into the settings, ideally between the CallbackPassword and InstallID ones. The new section looks like this:

<setting name="MD5Secret" serializeAs="String">
     <value />
</setting>

Now, we need to add a value to this setting. Go to your Kartris back end, Configuration > Payment and Shipping Gateways and you should see Worldpay near bottom. The verson should show as 2.1.0.1 (or above). Click to edit Worldpay.

You should see the new MD5Secret field. Add a value - this should be text, between 20 and 30 characters, no spaces. It must contain at least one number, one lowercase letter, one uppercase letter and one special character. Copy this value as you'll need it in the next step.

17.21.4.3. Add the setting into the Worldpay admin panel

You need to login to Worldpay, find the live account settings for the correct install ID and update a couple of fields.

First, the MD5 Secret. You should copy exactly the same value into the new MD5Secret field you just added into your Kartris back end.

You will also need to add the following to the Signature fields: instId:amount:currency:cartId

Save the settings. If there are errors reported with your MD5 Secret value, fix them, but ensure that you copy any changes back into Kartris, so your MD5 secrets in both places match.