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. If you set up a Payment Response Password in WorldPay, enter the same password in Payment Response Password. If you did not set up a password, skip this step.
  6. Click Save Changes.
  7. Log in to the WorldPay Merchant Administrator Interface.
  8. Click SETUP.
  9. In the Integration Setup: PRODUCTION column, click the icon for the Select Junior installation.
  10. 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. 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
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: 2025 October 27