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-Time | Recurring | Refunds | Reversals |
| ✓ | ✖️ | ✖️ | ✖️ |
| 3D Secure | Remote Update Card | Remote Delete Card | AddPayMethod API |
| ✖️ | ✖️ | ✖️ | ✖️ |
Adding the WorldPay Payment Gateway
To set up the WorldPay payment gateway in WHMCS:
- Go to Configuration () > Apps & Integrations or Addons > Apps & Integrations.
- Click WorldPay.
- Check Show on Order Form to display this payment method in the Client Area during checkout.
- Enter your WorldPay installation details.
- 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.
- Click Save Changes.
- Log in to the WorldPay Merchant Administrator Interface.
- Click SETUP.
- In the Integration Setup: PRODUCTION column, click the icon for the Select Junior installation.
- Check the following checkboxes:
- Enable the Shopper Response
- Payment Response enabled?
- Enable Recurring Payment Response
- Set the Payment Response URL to
<WPDISPLAY ITEM=MC_callback>. - 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 Issue | Cause | Next Steps |
Attribute value of type NMTOKEN must be a name token | This error occurs because the credit card storage function is disabled. | WorldPay Invisible NMTOKEN Errors |
Last modified: 2025 October 27