Google Pay payment handler

Overview

Google Pay payment handler for Universal Commerce Protocol (UCP) enables users and merchants to use Google Pay as a credential provider on Google AI surfaces like Gemini and AI Mode. Using Google Pay, users select their preferred payment method from Google Wallet during checkout. Google Pay then conveys this selection to the merchant as a secure payment instrument to complete the transaction.

You can use your existing payment system - Google Pay works with Payment Service Providers (PSPs) around the world.

Merchant integration for checkout

Payment processing options

  • PAYMENT_GATEWAY integration is ideal for merchants that use a supported payment service provider gateway. With gateway integration, Google includes an encrypted payload in checkout completion that you convey to your PSP for processing.
  • DIRECT integration is optional for PCI DSS Level 1 compliant merchants that can provide documentation. This integration requires you to decrypt payment credentials and process them directly with the card networks.

Declaring payment handler support

The Google Pay payment handler declaration indicates that your business accepts Google Pay, what payment methods and networks you support, and lets you request additional information to transact and fulfill orders.

Configuration

Google Pay payment handler is identified by the name com.google.pay inside the payment_handlers object.

The following table describes the properties of the payment handler configuration object:

Property Type Necessity Description
id string Required A unique identifier for this handler instance.
version string Required