The Worldpay payment gateway allows you accept credit card payments via a secure, hosted payment page without needing an SSL certificate on your WooCommerce store. The payment process takes place in a single tab, for a seamless user journey.

Worldpay handles all major payment methods, debit cards and credit cards, including Diners, MasterCard, Visa, Amex, Maestro and JCB. After completing payment, the order is confirmed and the customer is taken to a Thank You page on your site.

We recommend using the MD5 setting for additional security. The transaction information will include an encrypted value that is used to check that data sent to Worldpay has not been modified.

Installation and Updating ↑ Back to top

For a new installation please review our extension installation guide

If you need to update the extension you can do this from your WordPress admin if you have connected the site to, you can read more about that here

You can also update manually by downloading the latest version from your WooCommerce account

Once you have the zip file downloaded you should deactivate and delete the existing version from your WordPress plugins page and then install the new version using the upload option. You will not lose any settings or data by updating this way.

Setup and Configuration ↑ Back to top


Go to: WooCommerce > Settings > Checkout > Worldpay.

Add the Installation ID, supplied by Worldpay, to your settings in WooCommerce. You should create a Payment Response password. Using the MD5 secret is recommended. Once entered you should save the settings.

If you are using Worldpay with WooCommerce Subscriptions (Worldpay call this FuturePay) or if you want to be able to process refunds from your WooCommerce admin then you will need to enter a Remote Administration Installation ID and Remote Administration Installation Password. These are provided by Worldpay, you will need to request them, they are not issued by default when you apply for an account.

Visit and click Account Login
Visit and click Account Login
Use the Business Manager Login link
Use the Business Manager Login link
Login with your username and password
Login with your username and password
Choose your Merchant Code
Choose your Merchant Code
Click Setup and then the "Select Junior" Test Integration Setup "cog"
Click Setup and then the “Select Junior” Test Integration Setup “cog”


Enter the settings from your WooCommerce settings page and select the boxes indicated.

  • Change ‘Store-builder used’ to ‘Other’
  • Set ‘store-builder: if other – please specify’ as ‘WooCommerce’
  • ‘Payment Response URL’ will be found in your WooCommerce settings for the gateway plugin. Make sure you copy this exactly as it is shown.
  • Tick ‘Payment Response enabled?’
  • Tick ‘Enable Recurring Payment Response’
  • Tick ‘Enable the Shopper Response’
  • ‘Payment Response password’ needs to be set using the same value from your WooCommerce settings
  • ‘MD5 secret for transactions’ needs to be set using the same value from your WooCommerce settings – if you have left it blank in your WooCommerce settings then you can leave it blank here.
  • ‘SignatureFields’ needs to be set using the same value from your WooCommerce settings – if you have left the MD5 secret blank in your WooCommerce settings then you can leave this blank.
Worldpay settings, shown in your WooCommerce settings
Worldpay settings, shown in your WooCommerce settings

Using Pre-Auth ↑ Back to top

If you want to Pre-Authorize payments and capture the funds later you can use the “Authorisation Mode” setting in the WooCommerce Worldpay settings.

You will need to check your settings at Worldpay to make sure that the “Capture Delay” is set to off, shown here

Set the Capure Delay to off

WorldPay FuturePay – WorldPay & Subscriptions ↑ Back to top

The WorldPay gateway for WooCommerce supports subscription payments  with WooCommerce Subscriptions (separate purchase). Worldpay calls this Futurepay.

On Subscriptions:

  • Subscriptions can only be modified if there is more than 2 weeks for the next payment.
  • Subscriptions with a regular payment schedule of less than 2 weeks between payments CANNOT be modified. They can only be cancelled.
  • Cart cannot contain more than one subscription but can contain a subscription product and an ordinary product.
  • Subscriptions can be cancelled from your WooCommerce admin or from the customer’s My Account page. To do this you MUST APPLY TO WORLDPAY for a Remote Administration Installation ID and enter the ID and password in to your settings. If you don’t enter a valid Remote Administration Installation ID and password, you can cancel the subscription in your WooCommerce admin but also need to cancel in your Worldpay FuturePay admin area.
Enter your Remote Administration details to activate the ability to cancel subscriptions from your WooCommerce Admin

URL Submission Method ↑ Back to top


The advantage of the URL method is that there is one less page for your customer to visit, disadvantages are the recipient can see all the attributes and values in the URL string so you may not feel it is secure. This is an important difference when compared with the FORM method.

You should add an MD5 Secret to your Worldpay settings if you are using the URL method.

Customization ↑ Back to top

Note: This is a Developer level section. If you are unfamiliar with code and filters and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our  Support Policy.

Adding Custom Arguments Sent To Worldpay ↑ Back to top

From version 3.4.1 onwards you can modify the list of arguments that is sent to Worldpay, allowing you to add your own, which can then be included in emails.

For example:

add_filter( 'woocommerce_worldpay_args', 'custom_woocommerce_worldpay_args', 10, 2 );
function custom_woocommerce_worldpay_args( $worldpay_args, $order ) {
$worldpay_args['MC_test_field'] = 'This should show up somewhere';
return $worldpay_args;}

You will need to login to Worldpay and modify the email templates to use this additional information. your field name should be prefixed with “MC_” as in the example above.

You should not modify the standard fields, these are required by Worldpay and changing them could prevent your customer from checking out.

Troubleshooting ↑ Back to top

Customer is not redirected back to your website after payment ↑ Back to top

You can find the correct Payment Response URL in your Worldpay settings in your store. Make sure that you paste this into your Worldpay settings exactly as it is on your site. If your URL starts with HTTPS and your customers are not redirected back to the site then change the HTTPS to HTTP and test, Worldpay can have issues when returning to HTTPS URLs if the SSL certificate uses SNI, this is a known issue at Worldpay. If this does not resolve your issue then you may need to use a ResultY.html file : please see the section below for instructions on how to create that.

How to create a resultY.html file in the Worldpay file manager ↑ Back to top

If you are using pretty permalinks in your WorldPress settings then use this to create your resultY.html file

If you are NOT using pretty permalinks then use this to create your resultY.html file

Login to Worldpay
Login to Worldpay

Click "Setup" then "Edit Payment Pages"
Click “Setup” then “Edit Payment Pages”

Choose your installation
Choose your installation

Then go to "file management"
Then go to “file management”

Now load your resultY.html
Now load your resultY.html file. Use resultY.html in the name field.
THE FILE NAME IS EXTREMELY IMPORTANT. If you see any warning messages you can ignore them.

Don’t forget to “Copy to Production”

BulletProof Security ↑ Back to top

If you have BulletProof Security installed and you experience issues with your customers not being returned to your site please review the information in this link

Sorry, there was a problem processing your payment ↑ Back to top

If you see this error then you should contact Worldpay and give them the reference number indicated in the screen shot – it will begin with an “a” or a “b”

Dynamic Callback Option ↑ Back to top

DO NOT use the Dynamic Callback option unless you use the same Installation ID on multiple sites. It is a less reliable option and will not allow you to process refunds in your WooCommerce admin or use Subscriptions.


Worldpay decommissioning URLs ↑ Back to top

The plugin does not use any of the URL’s that are being decomissioned, there is no need to update or make any changes. You can read more about the decomissioning here

Feedback and feature requests ↑ Back to top

For feedback on the Worldpay gateway, this documentation or for feature requests please email

Questions & Support ↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch the developer via the Help Desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top