WorldPay

This module is available for all self-hosted WHMCS installations and for WHMCS Cloud’s Growth and Expansion plans.

This module allows you to use WorldPay for one-time invoices.

Supported Features

Type: Third-Party

One-TimeRecurringRefundsReversals
✖️✖️✖️
3D SecureRemote Update CardRemote Delete CardAddPayMethod API
✖️✖️✖️✖️

Adding the WorldPay Payment Gateway

To set up the WorldPay payment gateway in WHMCS:

  1. Go to Configuration () > Apps & Integrations or Addons > Apps & Integrations.
  2. Click WorldPay.
  3. Check Show on Order Form to display this payment method in the Client Area during checkout.
  4. Enter your WorldPay installation details.
  5. Click Save Changes.
  6. Log in to the WorldPay Merchant Administrator Interface.
  7. Click SETUP.
  8. In the Integration Setup: PRODUCTION column, click the icon for the Select Junior installation.
  9. Check the following checkboxes:
  • Enable the Shopper Response
  • Payment Response enabled?
  • Enable Recurring Payment Response
  1. Set the Payment Response URL to <WPDISPLAY ITEM=MC_callback>.
  2. Add the Payment Response Password value that WHMCS displays to your WorldPay account.
    The Payment Response Password value is required in order to process payments with WorldPay. For more information, see Payment Response Password Errors.
  3. Click Save Changes.

Test Mode

You can use test mode to simulate payment processing without actually causing a transaction to occur. This can be useful for testing your configuration.

Troubleshooting

You can find information about most payment gateway-related errors in the logs at Billing > Gateway Log and in the Module Log.

For more information, see Troubleshooting Payments.

You may encounter the following common issues:


Error or IssueCauseNext Steps
You have not configured a payment response password. or Your payment response password does not match.Your WorldPay module configuration does not currently include the required Payment Response Password value, or the value in WHMCS does not match the value in your WorldPay account.Payment Response Password Errors
Attribute value of type NMTOKEN must be a name tokenThis error occurs because the credit card storage function is disabled.WorldPay Invisible NMTOKEN Errors

Last modified: 2026 January 20