Getting Started

Building Blocks

Subscription Features



Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages

Attach Additional Data


Open Source Resources

Other Features

API Integration

Third Party Integrations


Worldpay  is a leader in payment processing technology. They operate on reliable and secure proprietary technology platforms that enable merchants to accept card payments across multiple channels.

Choosing Worldpay 

The following criteria need to be considered before choosing Worldpay as a payment solution:

  • Countries supported: Worldpay is currently supported for companies based in the USA, the United Kingdom, Hong Kong, and Singapore.

  • Payment Methods: Worldpay supports almost all major credit and debit cards such as Visa, MasterCard, American Express.

  • Pricing: For Worldpay's pricing details, click here .

Worldpay Accounts 

There are two types of Worldpay accounts that Chargebee supports: Corporate and Business Gateway accounts.

The Corporate Gateway account is Worldpay's global solution for large businesses that accept a large number of payments everyday.

The Business Gateway on the other hand is Worldpay's global solution for small and medium-sized businesses. It supports major card schemes and many alternative payment methods.

To use your Worldpay account with Chargebee, you will need Worldpay's XML Direct feature enabled. When requesting for the XML direct installation, you need to communicate to Worldpay that you will be using their services with Chargebee and Spreedly. The Recurring or FuturePay modules of Worldpay are not required since Chargebee handles the subscription management logic and we only need their payment processing capabilities.

A list of approved open shopping carts  is available in Worldpay, it is helpful to mention to their support team that Worldpay and Chargebee have common customers using this mode. Also, it has been established that Chargebee uses Spreedly, a certified service by Worldpay.

In the event that Worldpay requires a proof of purchase, please send a note to  and we'll help you with it.


Your Worldpay account should only have a single merchant ID for recurring payments.

Capture Delay

Charging a customer in Worldpay gateway involves two steps:

1) Authorization- Validates the customer's card and reserves the funds (Funds are not deducted from the customer's bank until capture)

2) Capture- Transfers the funds reserved in Authorization step from issuing bank to the acquiring bank (Funds are deducted from the customer's bank)

"Capture delay" is the delay between the Authorization and the Capture step.

When the capture delay is turned off, Authorization is initiated first and if the authorization succeeds, it will be immediately followed by a Capture request. The advantage of this two-step process is, if there's an Authorization request timeout, no Capture request will be made and this can reduce the risk of charging the customer twice.

IP Address

Worldpay Corporate Gateway, for security reasons, allows the API requests only from the IP address listed in the Worldpay portal. Since Chargebee is integrated with Worldpay via Spreedly, it is mandatory to add the Spreedly IP address in the Worldpay whitelist. If not added, all API requests initiated would be rejected by Worldpay and Chargebee won't be able to collect payments from the customer on behalf of the merchant. More on specifying IP addresses here .

Configuring Worldpay with Chargebee 

Merchants have the option to integrate using one of the two accounts they have with Worldpay:

1. Configuring a Corporate Gateway Account

To integrate using the Corporate Account, you must first go to Profile in WorldpayPayment Service › turn off the Capture Delay option.

2. Configuring a Business Gateway Account

To integrate using the Business Gateway Account, you must go to ProfileConfiguration Details › turn off the Capture Delay option.

Once the changes in either account is made, you must configure your Worldpay Merchant Code and XML Password. To do this, login to your Chargebee LIVE site and go to SettingsSite SettingsGateway Settings.

Known issue
If after you have configured your Worldpay production account credentials in Chargebee and you are getting an "Invalid Credentials" error during a payment transaction, it would most likely be because of the "XML Username". If this happens, you need to contact Worldpay support and request them to enable the "XML Username" as the Merchant Code. This is because Chargebee connects to Worldpay using the merchant code.

Testing the Worldpay Integration 

Integration with Worldpay is available on Chargebee's live site only. If you need to test transactions with Chargebee's test site, you can use Chargebee's test payment gateway as it is equipped to support all payment related scenarios. Test cards for testing with Chargebee's test gateway can be found here.

Currencies Supported 

Ensure that your transactional currencies are supported by both Worldpay and Chargebee.

You can find the list of supported currencies in the links below: