Last Updated: 31 July 2025 | Change Log

Magento

SMB (Worldpay eCommerce)

Use the Magento plugin to easily integrate your online store into Worldpay eCommerce.

Prerequisite

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

Magento version support

Developed for Magento version 2.4

Info

You must have the latest version of PHP.

How to get the plugin

  1. Install the Magento plugin.
  2. Ensure the resulting folder from the archive is named "WorldpayEcommerce" and that it contains the "Payment" folder.

How to add the plugin to Magento

  1. Access the merchant server via FTP/SFTP and go to the project where Magento is installed.

  2. Go to "app/code/" and upload the "WorldpayEcommerce" folder. The folder path is "/app/code/WorldpayEcommerce".

  3. Access the merchant server via SSH and go to the project root where Magento is installed.

Make sure you have the right permissions to run the following commands:

--- php bin/magento module:enable WorldpayEcommerce_Payment
--- php bin/magento setup:upgrade
--- php bin/magento setup:di:compile
--- php bin/magento setup:static-content:deploy

How to configure your Magento plugin

  1. Go to "Stores" in your Magento interface.

  2. Go to "Payment methods" and scroll down.

  3. Copy and paste your credentials and entity from your dashboard into the Magento config screen as shown below:

config1.png

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

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

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".

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

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

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 Magento config screen
  2. Copy and paste the credentials from your dashboard to the config screen. This time making sure they are going into the "Live" section.
  3. Ensure the "debug" toggle is off.
  4. You can now initiate a live transaction.

Errors & where to find support

Support

For any other issues or further support log into dashboard and visit our support centre.