Documentation, Reference Materials, and Tutorials for your WooCommerce products
Worldpay Online Payment Gateway
Sign up for your Worldpay Online account HERE
Quick Setup Guide ↑ Back to top
Worldpay have provided a quick guide to act as a handy reference during setup, download it here
Requirements ↑ Back to top
- A WordPress website with WooCommerce version 3.0.0 or higher installed.
- The Worldpay Online Payment Gateway
- An Online.Worldpay account – visit https://online.worldpay.com if you don’t have an account already.
- You will need an SSL certificate if you want to use the WooCommerce checkout form – this is recommended by Worldpay. If you do not have an SSL certificate you can use the checkout form provided by Worldpay
Installation and updating. ↑ Back to top
Please review our extension installation guide if you are installing the extension for the first time.
You can update the extension from your WordPress admin if you have connected the site to WooCommerce.com, you can read more about that here
Alternatively, 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 and settings or data by updating this way.
Setup and Configuration ↑ Back to top
Go to your WorldPress Admin, then WooCommerce -> Settings -> Checkout -> Worldpay Online
How to sign up for a test account and where to find your Service and Client Keys ↑ Back to top
Please watch this short video that shows how to sign up for a test account and where to find your Service and Client keys.
To sign up or login to your Worldpay Online account please visit https://online.worldpay.com/
Once you have created an account your keys will be located here https://online.worldpay.com/settings/keys
How to “Go Live” with Worldpay Online ↑ Back to top
You will need to apply for a live account with Worldpay using the “Activate” link in the top right corner or go to https://online.worldpay.com/activate.
If you are an existing Worldpay customer then you can contact Worldpay about migrating your account to Worldpay Online
Contact Andrew Benbow for Worldpay support
Andrew Benbow is ready to help you get the answers you need.
Thanks for contacting Andrew Benbow
Andrew Benbow will reply to your questions about Get extension name shortly.
While you wait, check out these handy resources:
Feedback for Andrew Benbow
We appreciate your feedback about your support experience with Andrew Benbow, developers of Worldpay. This helps us maintain high standards on the WooMarketplace, and helps Andrew Benbow improve.
Glad to hear it went well with Andrew Benbow. Tell us more.
Sorry to hear that. Can you tell us more?
Did Andrew Benbow get back to you?
How long did it take for you to hear back from Andrew Benbow
A few hours A day A few days
Was your issue resolved?
Sorry to hear that. Would you like our team to take a look at your issue?
Do you have any additional feeback for us or Andrew Benbow?
Has anything changed since you first reached out? Is there anything new that you’d like us to know?
Great! Any additional feedback?
Mobile Apps launch
NEW: Put your store in your pocket – manage orders, track sales, and get real-time order alerts with the new WooCommerce mobile app (iOS & Android).
By continuing, you agree to their use. Learn more, including how to control cookies.
The most customizable eCommerce platform for building your online business. Get started today for free.
- Extension Type: Off-Site, WooCommerce Extensions, Payments
- Last Updated: 2018-12-10
- Developer: Andrew Benbow
- Version history: View changelog
Worldpay Online Payments, the NEW service from Worldpay!
If you are new to Worldpay then get the new extension and sign up for the new service here!
A few key benefits of Worldpay Online:
- Simple and easy to setup!
- Keep your customer on your site
- Optionally, use Worldpay’s own credit card form to reduce PCI requirements, no SSL certificate required!
- FULL support for WooCommerce Subscriptions, Pre-Orders and Tokens
- Capture authorised payments from your WooCommerce admin
Take payments via Worldpay
The Worldpay gateway plugin lets you accept credit card payments via a secure, hosted payment page. Because Worldpay handle the payment process for you, no SSL certificate is required on your site.
Worldpay’s affordable online payment gateway enables your business to accept all major payment methods and credit and debit cards, including Diners, MasterCard, Visa, Amex, Maestro and JCB.
Hosted payment page
On your store, when an order is placed by a customer, the customer is taken to Worldpay to make a secure payment. After the customer completes their payment the order is confirmed and the user is taken to the thank you page on your site. This all takes place in one tab, for a seamless user journey.
Documentation, Reference Materials, and Tutorials for your WooCommerce products
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.
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 WooCommerce.com, 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 http://worldpay.com/uk and click Account Login Use the Business Manager Login link Login with your username and password Choose your Merchant Code 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 FuturePay – WorldPay & Subscriptions ↑ Back to top
The WorldPay gateway for WooCommerce supports subscription payments with WooCommerce Subscriptions (separate purchase). Worldpay calls this Futurepay.
- 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
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.
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’;
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
Click “Setup” then “Edit Payment Pages”
Choose your installation
Then go to “file management”
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 http://forum.ait-pro.com/forums/topic/403-woocommerce-worldpay-gateway/
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 [email protected]
Questions & Support ↑ Back to top
Already purchased and need some assistance? Get in touch the developer via the Help Desk.