WorldPay FuturePay

This module allows you to use WorldPay with FuturePay.

Supported Features

Type: Token

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

Adding the WorldPay FuturePay Payment Gateway

To set up the WorldPay FuturePay payment gateway in WHMCS:

  1. Go to Configuration () > Apps & Integrations or Addons > Apps & Integrations.
  2. Click WorldPay FuturePay.
  3. Check Show on Order Form to display this payment method in the Client Area during checkout.
  4. Enter your WorldPay FuturePay installation details.
  5. Click Save Changes.
  6. Log in to the WorldPay Merchant Administrator Interface.
  7. Click SETUP.
  8. In the Integration Setup: TEST 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. Click Save Changes.

Auth Mode A - Capture Delay

Auth Mode enables capture delay (formerly pre-auth mode). After you enable it, you can configure the delay period in the WorldPay Merchant Administration Interface. Capture Delay lets you specify a delay between payment authorization and capture. This can be helpful when determining whether you should fulfill an order since it allows you time to assess a transaction. You can cancel (void) a transaction through the WorldPay Merchant Interface before capture.

When you enable it, the client cannot tell whether you are using capture delay because invoices in WHMCS will still instantly display as paid and all automation will occur normally.

  • To automatically capture all payments without any delay, set Capture Delay in your WorldPay account to 0 and set AuthMode to A.
  • To automatically capture all payments with a delay of 1–14 days, set Capture Delay in your WorldPay account to that number of days and set AuthMode to A.
  • To disable automatic payment capture and manually capture all payments, set Capture Delay in your WorldPay account to OFF and set AuthMode to E.

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