Revision as of 20:04, 1 April 2022

About this Module

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

For information on the module to use the Limited Agreements payment system in WHMCS 8.1 and earlier, see WorldPay FuturePay.

Supported Features

Adding the WorldPay Payment Gateway

To set up the WorldPay payment gateway in WHMCS:

1. Go to Configuration () > System Settings > Payment Gateways or, prior to WHMCS 8.0, Setup > Products/Services > Payment Gateways.
2. Choose the All Payment Gateways tab.
3. Click WorldPay.
4. Check Show on Order Form to display this payment method in the Client Area during checkout.
5. Enter your WorldPay credentials.
6. Click Save Changes.
7. Log in to the WorldPay Merchant Administration Interface.
8. Go to System Settings > Integration Setup : PRODUCTION.
9. Set the Payment Response URL to <WPDISPLAY ITEM=MC_callback>.
10. Check Payment Response enabled?, Enable Recurring Payment Response, and Enable the Shopper Response.

Test Mode

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

Auth Mode A - Capture Delay

The auth mode is used to turn on capture delay. A = on. You then configure the delay period in the WorldPay admin. This used to be called pre-auth mode. Capture Delay enables you to specify a delay between the authorisation of a payment and its capture. This can be helpful when determining whether you should fulfil an order since it allows you time to assess a transaction. You can cancel (void) a transaction through the WorldPay Merchant Interface before capture, thereby saving you time and money by avoiding making a refund.

When enabled, the client will not be able to tell whether you are using capture delay as it behaves exactly the same; invoices in WHMCS will still instantly be marked as paid and all automation will take place as normal.

For example; a customer makes a payment and you want to Worldpay to automatically debit this payment from the customers' card then you would turn off capture delay. If you want to delay the capture then turn it on.

To automatically capture all payments without any delay

Set Capture Delay in your WorldPay account to 0 (zero) - set AuthMode on your Payment Gateway page to A.

To automatically capture all payments with a delay of 1-14 days

Set Capture Delay in your WorldPay account to a number 1-14 - set AuthMode on your Payment Gateway page to A.

To turn off automatic payment capture and manually capture all payments

Set Capture Delay in your WorldPay account to OFF - set AuthMode on your Payment Gateway page to E.

Troubleshooting

N/A