Skip to content

craftcms/commerce-worldpay

Repository files navigation

Worldpay for Craft Commerce icon

Worldpay Online Payments for Craft Commerce

This plugin provides a Worldpay integration for Craft Commerce.

This integration uses Worldpay's Online Payments API utilizing the features of the Omnipay Worldpay library.

Note: 3D secure is not currently implemented due to the underlying Omnipay library not supporting the feature.

Requirements

This plugin requires either:

  • Craft 4.0 and Craft Commerce 4.0 or later.
  • Craft 5.0 and Craft Commerce 5.0 or later.

Installation

You can install this plugin from the Plugin Store or with Composer.

From the Plugin Store

Go to the Plugin Store in your project’s Control Panel and search for “Worldpay for Craft Commerce”. Then click on the “Install” button in its modal window.

With Composer

Open your terminal and run the following commands:

# go to the project directory
cd /path/to/my-project.test

# tell Composer to load the plugin
composer require craftcms/commerce-worldpay

# tell Craft to install the plugin
./craft install/plugin commerce-worldpay

Setup

To add a Worldpay payment gateway, go to Commerce → Settings → Gateways, create a new gateway, and set the gateway type to “Worldpay Json”.

Tip: The Merchant ID, Service key, and Client key settings can be set to environment variables. See Environmental Configuration in the Craft docs to learn more about that.