WorldPay Direct Integration 

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.

Chargebee integrates with WorldPay's Worldwide Payment Gateway (WPG) platform.

Here are some important things that you need to know before you choose WorldPay as a payment solution:

  • Countries supported: Worldpay currently supports companies based in the USA, the United Kingdom, the European Union, and other global markets.
  • Payment Methods: Worldpay supports almost all major credit and debit cards such as Visa, MasterCard, and American Express.
  • Pricing: For Worldpay's pricing details, click here .

Integration Options 

Listed below are the integration options available between Chargebee and WorldPay:

# Methodology Description PCI Requirements 3DS supported?
1 Chargebee Checkout + WorldPay Gateway Card information of the customers are collected by Chargebee's checkout and passed on to WorldPay. Low
(Your PCI compliance requirements are greatly reduced because of Chargebee's checkout. As a merchant using Chargebee's checkout, all you have to do is submit a Self Assessment Questionnaire to stay compliant.)
2 Chargebee.js + WorldPay Gateway Card information of the customers are collected by Chargebee's JS and passed on to WorldPay. Low
(card details are tokenized by WorldPay)
3 Chargebee API + WorldPay Gateway Collection of card information must be handled at your end and passed on to Chargebee via the API. Chargebee will route this card information to WorldPay. High
(card information will be collected by you directly, you will have to take care of PCI Compliance requirements)

For more info, contact support


Following prerequisites are required for configuring the WorldPay gateway in your Chargebee site:

  • Create and set up your merchant account with WorldPay. Chargebee integrates with the WorldPay's Worldwide Payment Gateway (WPG) platform.

  • You must obtain the following details from your WorldPay account:

    • Merchant Code
    • XML Username
    • Password

    Log in to your WorldPay business account, click Profile and you can get the above details.

Configuring WorldPay 

To configure WorldPay in Chargebee, follow the below steps:

  1. Click Settings > Configure Chargebee > Payment Gateway > Add payment Gateway.

  2. Click WorldPay.

  3. Enter the Merchant Code, XML Username, and XML Password of your WorldPay account.

  4. Click Connect. The configuration page appears.

Configuring Card Settings 

To update the Cards Settings for WorldPay, follow these steps:

  1. Click Settings > Configure Chargebee > Payment Gateways > WorldPay, and click the Manage link in the Cards section. The Cards Settings page is displayed. Configure the following settings based on your business requirements:

  2. Cards verification: WorldPay mandates this setting to be enabled to process recurring payments faster and for better approval rates. Chargebee verifies the customer's card before adding them. In this process, a small amount will be debited from the customer's card and will be refunded instantly. In case this authorization fails, the customer cannot add their card.

  3. Allow Prepaid cards: Enabling this option allows your customers to use a prepaid card for their transactions.

  4. Always retain card information in WorldPay when the customer updates it: If you have configured multiple payment gateways in Chargebee, enabling this option stores the updated card information in WorldPay rather than the default gateway.

  5. Click Save > Apply.


Worldpay performs a $1 transaction for Card Verification by default. You can have this reduced to $0 by working with your Account Manager from Worldpay. Afterwards, inform Chargebee Support to reduce the authorization amount to $0 in Chargebee's integration to Worldpay.

Configuring Webhooks 

Webhooks are indispensable when it comes to integrating Chargebee with WorldPay as they pass crucial payment information such as payment status, based on which users can take action. Webhooks in this integration should be configured manually. Learn more about webhooks.

To configure webhook in your WorldPay account, follow these steps:

  1. Click Settings > Configure Chargebee > Payment Gateways > WorldPay, and copy the Notification URL under Webhooks.

  2. Log in to your WorldPay account.

  3. From the WorldPay dashboard, click Profile > Merchant Channel.

  4. Set up a Merchant Channel with the following settings in the ‘http' row:

    • Active: Yes
    • Content : XML
    • Paste the Webhooks URL copied from Chargebee in the Address field.
    • Method: Post
    • Send Idempotency Key: Yes
    • Select all Event checkboxes under the Merchant Channel's Events section.
  5. Click Save.

Currencies Supported 

Worldpay and Chargebee support 100+ different currencies for charging customers across different geographical locations. If you intend to use Worldpay+Chargebee for your business, ensure that your transactional currencies are supported by both. Find the complete list of currencies supported by:

Was this article helpful?