Viewing: developers.google.com

Overview Stay organized with collections Save and categorize content based on your preferences.

Page Summary

outlined_flag

Google Pay enables quick and easy checkout on websites by leveraging millions of cards saved to Google Accounts globally.
The Google Pay API securely returns a payment token to your website after a user selects a payment method, streamlining the transaction process.
Integrating Google Pay involves reviewing terms, selecting a supported processor, adhering to brand guidelines, and completing the provided tutorial and checklist.
Businesses can access resources such as live demos, sample tokens for testing, and a troubleshooting guide to support their integration process.
Production access to the Google Pay API is requested through the Google Pay & Wallet Console after successful integration and testing.

The Google Pay API enables fast checkout on your website, and gives you convenient access to hundreds of millions of cards saved to Google Accounts worldwide.

How it works

[how-gpay-works-web.svg] Figure 1. Web payment flow

When a user clicks the Google Pay payment button, they see a payment sheet that displays the payment methods saved to their Google Account, as well as optional fields such as a shipping address field. Users can quickly select a payment method, add an optional shipping address, or add new information.

The payment flow is as follows:

The user clicks the Google Pay payment button and sees a payment sheet with a list of supported payment methods.
The user selects a payment method and Google Pay securely returns a payment token for that method to your website.
Your website submits the payment token, along with details about the purchase, to its backend.
To execute the payment, the backend processes the purchase and sends the payment token to the payment service provider.

Get started

Perform the following steps to get started with the Google Pay API:

Review and adhere to our Google Pay API Terms of Service and Acceptable Use Policy.
Look through the supported processors and gateways list to find the reference documentation for your payment processor or gateway.
Note: If your processor or gateway isn't supported, you might be able to complete a Direct integration. The direct integration is exclusively available to merchants who are Payments Card Industry Data Security Standard (PCI DSS) compliant, as validated by a Qualified Security Assessor. Third parties that supply gateway or processing services on behalf of actual merchants aren't eligible to use the Direct integration.
Review and adhere to the Google Pay Brand guidelines.
Complete the Tutorial and Integration checklist.
Request production access to the Google Pay API through the Google Pay & Wallet Console.
Note: If you intend to submit more than 50 fully qualified domains (including subdomains), please get in touch beforehand using our contact support form for a possible alternative solution.

Resources

Use the following resources to complete your integration:

Reference our Live Google Pay demos.
Reference how to Test with sample tokens.
Reference our Troubleshooting guide if you encounter errors.

Codelabs

The following codelabs will help you get started on Web with the Google Pay API:

Videos

Blog posts

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-03-19 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-03-19 UTC."],[],["Users click a Google Pay button, which displays saved payment methods. After selection, Google Pay returns a payment token to the website. The website sends the token and purchase details to its backend. The backend then processes the payment, forwarding the token to the payment service provider. To start, review terms, find your processor, adhere to brand guidelines, and request production access through the Google Pay & Wallet Console. Additional steps are included for those with many domains.\n"]]