Google Pay via WorldPay
This feature is currently a Private Beta release. Contact Chargebee Support to enable Google Pay via WorldPay for your live and test sites.
Google Pay is a digital wallet that lets customers make secure payments using credit or debit cards stored in their Google Account. Chargebee supports Google Pay through your WorldPay Direct (Worldwide Payment Gateway) account.
Supported countries and currencies
Use currencies that both Chargebee and WorldPay support for your site. See Currencies supported by Chargebee and confirm currency enablement with WorldPay for your WorldPay account.
Integration options
Google Pay via WorldPay 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 Direct payment gateway in Chargebee. When you connect, enter your 3DS credentials; they are required for Google Pay transactions. If the gateway is already configured with 3DS credentials, continue to configuration.
Configure Google Pay in Chargebee
Follow these steps to configure Google Pay via WorldPay in your Chargebee site:
- Click Settings > Configure Chargebee > Payment Gateways > WorldPay.
- Enable Google Pay.
- Enter your Gateway Merchant ID. WorldPay provides this value.
- Enter your Merchant Name.
- Select the Merchant Country Code. This is the country or region where the payment is processed.
- Click Save to complete the configuration.
Configure Smart Routing
When you enable Google Pay via WorldPay, configure Smart Routing so WorldPay is the preferred gateway for Google Pay. If another gateway is already configured for Google Pay, update the routing preferences on the Smart Routing page.
- 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 gateway instance on your Chargebee site that has Google Pay enabled.
- Click Save.
Checkout flow
The following steps describe what the customer does when they pay with Google Pay in Chargebee checkout:
- Click Proceed to Checkout from the Your Order page to start the purchase.
- Select the Google Pay tab from the Add your payment details window.
- Click GPay.
- The Google Pay pop-up appears. The customer signs in to their Google Account and selects an existing card or adds a new card.
- After the payment succeeds, the customer returns to Chargebee and the payment method is linked to the customer. Recurring payments use the selected card in Google Pay.
Supported token formats
This section applies if you are building a custom checkout or migrating payment methods from another provider to WorldPay.
| 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 |
Payment features
The following table summarizes features for this integration:
| Feature | Description | Supported | Default state | Configuration / behavior |
|---|---|---|---|---|
| Integration sync mode | Defines how payment requests are processed and statuses are communicated between Chargebee and WorldPay. | Yes (Synchronous) | Synchronous | WorldPay 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. |
| 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 business-initiated (MIT). | Yes | Supported | The initial payment is customer-initiated through the Google Pay wallet. Subsequent recurring payments are business-initiated (MIT). |
| Error intelligence | Provides standardized categorization of payment failures. | Yes | Enabled | Available via WorldPay 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. |
Testing
Testing in sandbox
Use your WorldPay test account linked to your Chargebee test site to validate the Google Pay integration before you go live.
- Sign in to a Google Account with a saved card (or add a card) on a supported device and complete a test checkout.
- For gateway test scenarios, refer to the WorldPay testing documentation.
Testing in production
Before you move to live:
- Ensure Google Pay is fully configured in WorldPay and Chargebee, including 3DS credentials on the WorldPay gateway connection.
- Perform end-to-end testing with a real card to validate the complete payment flow.
Limitations and important points
- Google Pay via WorldPay is a Private Beta feature and must be enabled by Chargebee Support.
- WorldPay Google Pay requires 3DS credentials on your WorldPay gateway configuration in Chargebee.
- WorldPay Google Pay supports Visa, Mastercard, and American Express only.
- You cannot add a Google Pay payment method from the Chargebee dashboard; the customer must authorize the wallet.
Was this article helpful?