Skip to content
Plugins/
/
Install

Last updated: 10 April 2026 | Change log

WooCommerce

SMB (Worldpay eCommerce)

Use the WooCommerce Plugin to integrate your online store into Worldpay eCommerce.

Prerequisite

You must have a Worldpay eCommerce account with us and access to the Dashboard Portal.

Compatibility

The Plugin is designed to function as the only active payment or checkout-related Plugin in your store. Using it together with other third-party Plugins performing similar functions may lead to conflicts and unexpected behavior.

If issues occur, we recommend you:

  • deactivate all other payment, subscription, and checkout Plugins
  • test with only the Worldpay Plugin enabled

Go and watch our video tutorial on how to install the WooCommerce Plugin!


WooCommerce version support

Woocommerce version required at least: 8.4.0
Woocommerce version tested up to: 8.5.1
Wordpress required at least: 6.4.2
PHP version required at least: 7.4

How to get the Plugin

  1. Install the WooCommerce Plugin.
  2. Log in with your WooCommerce credentials.

Retrieve your credentials

  1. Log into your dashboard.
  2. Click on "Developer Tools".
  3. Click on "API Credentials".
  4. Choose "Try mode" and retrieve your credentials. You need:
    • your Try API username
    • your Try API password

Dashboard Try username and password example screenshot

  1. If you want to you use the embedded checkout, click on "Access Checkout". You also need:
    • your Try Checkout ID

Try Checkout ID example screenshot

Retrieve your entity

  1. Log into your dashboard.
  2. Click on "Developer Tools".
  3. You can find your entity next to "Entity" usually prefixed with "PO".

Dashboard entity example screenshot

Installing the WooCommerce Plugin

  1. In your WordPress Admin Dashboard, go to "Plugins" then click "Add New" then click "Upload Plugin"

  2. Click "Install"

  3. Once installed click "Activate"

  4. Go to the "Payments" tab and tick the box to "Enable Worldpay"

    WordPress Payments tab, enable Worldpay box screenshot

  5. Scroll down and enter your Worldpay Try username and password in the "Try API Credentials" section

    Try username and password form screenshot

  6. "Save changes"

Setup recurring payments

You can offer subscription payments by navigating to "Settings" and then clicking on the "Subscriptions" tab in your WooCommerce dashboard.

You can find full instructions on how to setup your recurring offering in the WooCommerce subscription management guide.

Among other things, the portal allows you to:

  • edit button text
  • set subscriber roles
  • enable retries and customer notifications
  • set a sales price - the initial charge that is lower than any subsequent amounts of the subscription e.g. promotions, offers etc.
  • set a subscriptions price - the recurring subsequent amount you want to charge in the subscription
  • set renewal schedules
  • enable sign-up fees
  • set free trial periods

Testing

Note

Once you have configured your WooCommerce Worldpay Plugin, you can take test transactions using our test card numbers.

To view your test transactions, log into your WordPress Admin Dashboard. Click on "Orders" where the test transactions appear.

WordPress Orders tab screenshot

Go live

These are the steps you need to follow to go live:

  1. Log into your dashboard.
  2. Click on "Developer Tools".
  3. Click on "API Credentials".
  4. Choose "Live mode" and retrieve your credentials. You need:
    • your Live API username
    • your Live API password

Dashboard Live mode username and password example screenshot

  1. If you are using embedded checkout, click on "Access Checkout" and get:
    • your Live Checkout ID

Live mode Checkout ID example screenshot

Your Live credentials and Checkout ID are different to any other Worldpay credentials you already have. The entity used for production transactions is the same for Try and Live.

  1. Navigate to the WooCommerce "Payments" screen in your WordPress Admin Dashboard.
  2. Tick the "Enable live mode" box.
  3. Copy and paste the credentials from your dashboard to the config screen. This time making sure they are going into the "Live API Credentials" section. Live API Credentials screenshot
  4. Ensure the "debug" toggle is off.
  5. You can now initiate a live transaction.