Quick Setup Guide
Worldpay have provided a quick guide to act as a handy reference during setup, download it here
Requirements
- 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.
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
Go to your WordPress Admin, then WooCommerce -> Settings -> Payments -> Worldpay Online
How to sign up for a test account and where to find your Service and Client Keys
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
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
Explanation of the Worldpay Online settings in WooCommerce
| TITLE | DESCRIPTION |
|---|---|
| Enable/Disable | Determines if the gateway is enabled or disabled. Check the box to enable and allow your customers to use Worldpay Online to pay |
| Testing | Check this while you are setting up the site, uncheck it once you are ready to process live orders for real money. |
| Checkout Form | By default this is the built in WooCommerce checkout form, it provides a seemless and integrated checkout experience. If your site does not have an SSL certificate you can opt to use the Worldpay checkout form by unticking this option. |
| Payment Action | Capture the payment immediately or Authorise the card now and capture the payment later, orders will be marked as Authorised and can be captured from your WooCommerce Admin |
| 3DS Enabled | 3D Secure, also known as “Verified by Visa” and “MasterCard SecureCode”, provides an additional step during checkout resulting in additional security for you and the customer – this step will only show if the customer’s bank is enrolled in the 3D Secure scheme |
| Title | What the customer sees during the checkout |
| Description | What the customer sees during the checkout, displays under the title. |
| Tokens / Card-on-file Payment | Let your customers securly store their card details for faster checkout. The card information is not stored in your database, it is stored securely at Worldpay and your database will hold a token that will allow that card to be charged in the future. Tokens will always be used for Subscription orders, Pre-Orders and Authorized orders. |
| Settlement Currency | Choose your preferred settlement currency, this is currency you will be paid in by Worldpay. |
| Live Service Key | Enter your live service key if you have one, you will need this to process live orders, this is supplied by Worldpay and can be found here |
| Live Client Key | Enter your live client key if you have one, you will need this to process live orders, this is supplied by Worldpay and can be found here |
| Test Service Key | Enter your test service key if you have one, this is supplied by Worldpay and can be found hereIf you don’t have one you can leave this blank and place test orders using the WooCommerce test service key. |
| Test Client Key | Enter your test client key if you have one, this is supplied by Worldpay and can be found hereIf you don’t have one you can leave this blank and place test orders using the WooCommerce client key. |
WooCommerce Checkout Form
Shown in the StoreFront theme.
Worldpay Checkout Form
Shown in the StoreFront theme.
Feedback and feature requests
For feedback on the Worldpay Online gateway, this documentation or for feature requests please email support@chromeorange.co.uk
Migration from Worldpay Form
If you have an Worldpay Online account then you can simply add your keys to the Worldpay Online settings and then deactivate Worldpay Form, that’s it!
If you are using Subscriptions then it will be more complex, there is no way to migrate the Subscription Payments from Worldpay Form to Worldpay Online. Your customers will need to re-enter their card information when the subscription runs out – any payments that are outstanding will continue to be collected until such time as Worldpay stop the Future Pay service. There is no ETA for that at this time.