Magento 2 Worldpay Payment

Magento 2 Worldpay Payment integrates UK's popular Worldpay Payment Gateway with Magento 2 to accept secure online payments.


Table of Content

  1. Extension Installation Guide
  2. Worldpay Payment Configuration
  3. Payment Methods Configuration
  4. Worldpay Payment in Frontend
  5. Worldpay Payment in Backend


  1. Extension Installation
  • Extract the zip folder and upload our extension to the root of your Magento 2 directory via FTP.
  • Login to your SSH and run below commands step by step:
    • composer require worldpay/worldpay-lib-php
    • php bin/magento setup:upgrade
    • For Magento version 2.0.x to 2.1.x - php bin/magento setup:static-content:deploy
    • For Magento version 2.2.x & above - php bin/magento setup:static-content:deploy –f
    • php bin/magento cache:flush
  • That’s it.


  1. Worldpay Payment Configuration
    For configuring the extension, log in to Magento 2, move to Sales > Payment Methods where you can find various settings to enable the extension.
  • Sandbox: Set “YES” to enable sandbox mode.
  • Test Service Key: Enter service key you have got while registration.
  • Test Client Key: Enter client key you have got while registration.
  • Default Settlement Currency: Set default settlement currency.
  • Shop Country Code: Select your Magento store Country code.
  • New Order Status: Set status for new orders.
  • Payment Description: Add payment description
  • Language Code: Add language code.
  • Sitecodes: Add sitecodes to differentiate orders from multiple stores.



  1. Payment Methods Configuration
    To enable various payment methods supported by Worldpay, configure the following settings:
  • Enabled: Set “YES” to enable Worldpay cards payment method from here.
  • Title: Set title for the payment method.
  • Payment Action: Select payment action
  • Save card Token: Set “YES” to save card token details for future transactions.
  • Use 3D secure: Set “YES” to use 3D secure.
  • Enable Debug: Set “YES” to enable debug.

Likewise, enable other Worldpay payment methods you want to use and configure them.



  1. Worldpay Payment in Frontend
    Once the extension settings are done, you can see Worldpay Payment enabled in the frontend. When a customer adds products to cart and proceeds to make payment, he will get the options to select the payment method. One of the Worldpay payment methods, i.e., Worldpay cards is shown below where the customer has to add card details to proceed payment.


  • Worldpay Payment Details in “My Account”
    Check the Worldpay Payment details in “My Account” section as shown below. Under “My Orders” tab, all the details of Worldpay payment method are displayed as a part of Order Information.

  1. Worldpay Payment in Backend
    The Worldpay payment method details can be seen from the backend under Sales > Orders > Order view section.