Worldpay US eCom 

Worldpay US eCom formerly known as Vantiv Litle is the leader in payment processing technology. They enable merchants from the USA and Canada to accept card payments across channels. This documentation is only for merchants based in North America.

In case you are based in Europe or any other part and wish to integrate Worldpay with Chargebee, please refer to this documentation.

Types of Accounts 

Worldpay (Vantiv Litle) has 4 types of accounts: Sandbox, Pre-live, Post live and Production. Of the four, you can integrate your Post live account with Chargebee's test site and the Production account with Chargebee's Live site.


  • In order to configure the payment gateway, you must first link your Vantiv Litle Merchant ID with Chargebee's partner account. Please contact Vantiv's support to get this done.
  • In case you have allow-list IP addresses in Worldpay (Vantiv Litle), please remove them.

Worldpay (Vantiv Litle) when integrated directly requires you to get certified before going live. The purpose of this certification process is to verify if the transaction submissions meet their requirements. While testing for certification, Worldpay will pose specific test scenarios that use specific data sets simulating real transactions. This certification is not required if you are using Chargebee to integrate with Worldpay (Vantiv Litle).


  • Click Settings > Configure Chargebee > Payment Gateways > Add Payment Gateway > Worldpay US eCom (formerly Vantiv)

  • Make sure that you get your Vantiv Litle Merchant ID linked with Chargebee's partner account. Payments will not pass through if you do not do this. Click Connect once your accounts are linked.

  • Enter the Merchant ID of the currencies configured in Worldpay (Vantiv Litle). Please do note that Chargebee does not cross verify the ID's entered here. Therefore exercise extra caution while mentioning the IDs. Click Proceed.
  • You have now successfully configured the integration between Worldpay (Vantiv Litle) and Chargebee. You can manage the settings from the Worldpay (Vantiv Litle) Settings page shown below.
  • To change the Cards Setting, click the Manage link. The Cards Settings page will open.

    • Card Verification will be enabled by default.
    • Enable Always retain card information in Vantiv when customer updates it option if you wish to store the updated card information in Vantiv rather than the default gateway.
  • You can choose to edit the Display Name by clicking the edit icon next to it. If you wish to add or edit the Merchant ID of the currencies, click the Manage link.

Migration of existing tokens/payment methods in Worldpay US eCom (Vantiv) into Chargebee is not supported at this point. Existing customers have to enter their card details again to process payments through this integration.

Vantiv CNP Token Migration 

Chargebee supports card token migration for Vantiv gateways. Currently, Vantiv does not support token-based payment method retrieval operations. However, Chargebee enables merchants to transfer tokens without requiring token retrieval from Vantiv by sending card-related information in addition to CNP tokens (payment method tokens) to Chargebee.

The following are some points to consider for the token migration:

  • Chargebee does not support token verification because Vantiv does not support retrieval of payment method details using tokens either.
  • If an invalid token is migrated, the payments will fail. You should ensure the token is valid before vaulting with Chargebee.
  • You have to provide cnpToken , networkTransactionId , expiry_month, expiry_year, Chargebee Customer ID, Vantiv gateway account ID from your Chargebee site, and type as "card" which is mandatory
  • Worldpay recommends providing the Network transaction ID to ensure successful recurring transactions.
  • You can migrate your tokens using Chargebee permanent token API . Refer to the parameters for Vantiv migration  for additional information on how to send data for migration.

Currencies Supported 

Each account in Worldpay (Vantiv Litle) can have access to only one currency. If you wish to configure multiple currencies in Worldpay, then you will have to create multiple accounts. Learn more.

The following currencies are supported:

  • US Dollar (USD)
  • Canadian Dollar (CAD)
  • Euro (EUR)
  • British Pound (GBP)
  • Czech Koruna (CZK)
  • Danish Krone (DKK)
  • Norwegian Krone (NOK)
  • Polish Zloty (PLN)
  • Swedish Krona (SEK)
  • Swiss Franc (CHF)
  • Australian Dollar (AUD)
  • Hong Kong Dollar (HKD)
  • New Zealand Dollar (NZD)
  • Singapore Dollar (SGD)
  • South African Rand (ZAR)

Please do make sure that you mention the correct Merchant ID for the currencies while configuring the integration.

Was this article helpful?