​
Overview

The Google Pay API enables fast, secure checkout and provides access to hundreds of millions of cards saved in Google Accounts worldwide. Once a merchant is configured for Google Pay, the Hosted Payment Page (HPP) will automatically show the Google Pay button when the customer is using a supported device and browser (e.g., Chrome with Google Pay enabled).

​
How It Works

When a customer clicks the Google Pay button on the Hosted Payment Page (HPP), the following flow occurs:
  1. The Google Pay payment sheet opens and displays the customer’s saved payment methods.
  2. The customer a preferred payment method (e.g., card) and confirms the payment.
  3. Google Pay generates and returns a secure token that represents the selected payment details.
  4. The Hosted Payment Page (HPP) forwards this token to PO payment gateway for processing.
  5. The transaction is completed through the configured acquirer, and the customer is redirected to the appropriate success or failure page, based on your integration settings.

​
Web Payment Flow

Figure 1 – Web payment flow Figure 1: Web payment flow for Google Pay transactions initiated via Hosted Payment Page.

​
Supported Devices & Browsers

Google Pay will only appear on the Hosted Payment Page (HPP) if the following conditions are met:
  • The merchant account supports Google Pay.
  • The user is using a compatible device:
    • Android device with Google Wallet and Chrome browser.
    • Desktop Chrome browser with Google Account and saved cards.
  • The user has at least one eligible card saved in Google Wallet.

​
Key Points

​
Merchant Configuration

  • The merchant must be configured for Google Pay.
  • The Merchant ID (DASMID) must be included in the Hosted Payment Page (HPP) payload.
  • If the configuration is correct, the Google Pay button appears automatically.

​
Payment Button Logic

  • Google Pay will only be shown if:
    • The merchant account supports Google Pay.
    • The user is using a compatible browser (Chrome).
    • The user has Google Pay configured with eligible cards.

​
Test the Hosted Payment Page with Google Pay

You can test a Google Pay Hosted Payment Page (HPP) integration by trying out our API endpoint here: Try the Hosted Payment Page Endpoint

​
Notes

  • No additional development is needed if using the Hosted Payment Page — Google Pay is automatically handled and tokenized securely.
  • This approach keeps you PCI-light, meaning your system avoids directly handling sensitive card data — simplifying compliance with PCI DSS requirements.
  • If a customer is not eligible for Google Pay (unsupported browser or no saved cards), the button will not appear.
Need help enabling Google Pay? Contact Support or reach out to your account manager.