Google Pay via Worldpay US eCom (Vantiv)
This feature is currently a Private Beta release. Contact Chargebee Support to enable Google Pay via Worldpay US eCom (Vantiv Litle) for your live and test sites.
Google Pay is a digital wallet that lets customers make secure payments using any card (credit or debit) stored in their Google Account. With this integration, you can select Google Pay as a payment method and process payments through your Worldpay US eCom (Vantiv Litle) account.
Integration options
Google Pay via Worldpay US eCom (Vantiv Litle) is supported across the following Chargebee integration options:
| Integration method | Description | Supported |
|---|---|---|
| Chargebee API | Integrate directly with the Chargebee API to accept Google Pay payments. | Yes |
| Chargebee hosted pages | Accept Google Pay through Chargebee's hosted checkout pages. | Yes |
| Chargebee JS | Build a custom checkout that accepts Google Pay using Chargebee JS. | Yes |
Prerequisites
- Configure your Worldpay US eCom (Vantiv Litle) payment gateway in Chargebee. If already configured, move to the next step.
Set up Google Pay in the Google Pay & Wallet Console
Complete the following steps in your Google Pay & Wallet Console before configuring Google Pay in Chargebee:
- Generate your Google Merchant ID and publish your integration by following these steps.
- In the Google Pay API tab, under Add an integration, add a Direct integration.

- In the Direct integration page, generate a public key using OpenSSL and add it as your Public encryption key in Base64-encoded, uncompressed point format by following these steps.

- Add a Web integration and select the integration type as Direct. The Direct integration uses your merchant public key to encrypt payment data.

- Ensure that both the Direct integration and the Web integration are active before configuring Google Pay in Chargebee.
Configuring Google Pay via Worldpay US eCom (Vantiv Litle) in Chargebee
Follow these steps to configure Google Pay via Worldpay US eCom (Vantiv Litle) in your Chargebee site:
- Click Settings > Configure Chargebee > Payment Gateway > Worldpay US eCom (Vantiv Litle).
- Enable Google Pay.

- Enter your Google Merchant Account ID. You can find your Merchant ID on the top-right side of your Google Business Console account.
- Enter your Merchant Name. This is required if you are operating in the European Economic Area (EEA).
- Select the Merchant Country Code. This is the country or the region where the payment will be processed.
- Enter your Public Key (Base64 format).
- Enter your Private Key (Base64 format). This pairs with your public key and is used for wallet payment configuration in Chargebee. Store it securely.

- Click Save to complete the configuration.
Configure Smart Routing
When you enable Google Pay via Worldpay US eCom (Vantiv Litle), configure Smart Routing to set it as the preferred gateway for Google Pay. If another gateway is already configured for Google Pay, you can update the routing preferences on the Smart Routing page.
Follow these steps to modify the Smart Routing settings:
- In your Chargebee Billing site, go to Settings > Configure Chargebee > Payment Gateways.
- Click Manage Rules under Smart Routing.

- Go to the Google Pay section and click Add a Gateway (or the Edit icon) for the relevant currency.

- From the Choose a payment gateway dropdown, select the Worldpay US eCom (Vantiv Litle) gateway instance from your Chargebee site with Google Pay enabled.
- Click Save.

Payment workflow
The following steps are involved in the customer's payment flow when they select Google Pay using Chargebee's checkout:
- Click Proceed to Checkout from the Your Order page to initiate a purchase.

- Select the Google Pay tab from the Add your payment details pop-up window.

- Click GPay.

- The Google Pay pop-up appears. The customer is prompted to sign in to their Google Account. The customer can choose to select an existing card or add a new card to make the payment.

- Once the payment is made, the customer is redirected to Chargebee and the payment method is successfully linked to the customer. Recurring payments are made using the selected card in Google Pay.
Payment features
The following are the features for this integration and details about them:
| Feature | Description | Supported | Default state | Configuration / behavior |
|---|---|---|---|---|
| Integration sync mode | Defines how payment requests are processed and statuses are communicated between Chargebee and Worldpay US eCom. | Yes (Synchronous) | Synchronous | Worldpay US eCom processes Google Pay payments synchronously. Chargebee receives the payment status in the gateway response. |
| Capture settings | Payment processing involves two stages: Authorization and Capture. Capture settings determine when funds are collected after authorization. | Yes | Auto capture | Auto capture is the default and only supported capture setting for Worldpay US eCom. No additional configuration is required. |
| Verification modes | Defines how payment methods are verified before processing. | Yes | Enabled | The Google Pay token is verified during payment processing. No additional configuration is required. |
| Statement descriptor | Displays the business name on the customer's bank or card statement, helping them recognize charges and reducing disputes. | Yes | Disabled | Configure this under Settings > Configure Chargebee > Transaction Descriptor. |
| Chargeback management | Handles chargeback events and applies configured actions on invoices and subscriptions. | Yes | Disabled | Enable Chargeback Management under Settings > Configure Chargebee > Billing LogIQ > Payments > Chargeback Management. |
| Fraud management | Uses gateway fraud signals to identify and flag high-risk transactions. | No | NA | No Google Pay-specific fraud configuration is available in Chargebee. |
| Transaction initiation type | Identifies whether a transaction is customer-initiated (CIT) or merchant-initiated (MIT). | Yes | Supported | The initial payment is customer-initiated through the Google Pay wallet. Subsequent recurring payments are merchant-initiated. |
| Error intelligence | Provides standardized categorization of payment failures. | Yes | Enabled | Available via Worldpay US eCom response codes. No configuration is required. |
| Gateway transaction details | Provides access to raw gateway responses for transactions. | Yes | Enabled | Available on the transaction page under Error details. No configuration is required. |
| Addition of payment methods in Chargebee dashboard | Allows a payment method to be added in Chargebee when details are collected outside the platform. | No | NA | Google Pay requires customer authorization through the wallet and cannot be added through the Chargebee dashboard. |
Supported token formats
This section is relevant if you are building a custom checkout or migrating payment methods from another provider to Worldpay US eCom.
| Token type | Description | Supported | Token field | Token format |
|---|---|---|---|---|
| Chargebee Payment Intent | Recommended token format when building a custom checkout using Chargebee JS. | Yes | payment_intent[id] | payment_intent_id |
| Chargebee token | Legacy token format supported for selected payment methods and gateways with Chargebee JS. Not recommended for new implementations. | No | token_id | NA |
| Gateway permanent token | Permanent reference provided by the gateway and used for future recurring payments or migrations from another PSP. | Yes | payment_method[reference_id] | customer_id/payment_source_id |
Testing
Testing in sandbox
Use your Worldpay US eCom (Vantiv Litle) Pre-live account linked to your Chargebee test site to validate the Google Pay integration before going live.
- Sign in to a Google Account with a saved card (or add a card) on a supported device and complete a test checkout.
- Live cards used in the Google test environment do not create actual transactions.
Note
Google Pay via Worldpay US eCom (Vantiv Litle) does not support test cards. You must use a real (live) card saved to your Google Account to test the integration.
Testing in production
Before moving to live:
- Ensure Google Pay is fully configured in Worldpay US eCom (Vantiv Litle) and Chargebee.
- Perform end-to-end testing using a real card to validate the complete payment flow.
Was this article helpful?