1. Documentation /
  2. WooPayments Documentation /
  3. WooPayments: Payment Methods /
  4. Accepting Google Pay with WooPayments

Accepting Google Pay with WooPayments

WooPayments provides your store with Google Pay, which makes it easier for customers to checkout quickly using their saved Google account details.

This document describes how to set up, test, and troubleshoot the Google Pay feature in WooPayments.

Google Pay button in the WooCommerce cart

NOTE: Google Pay is available for all countries supported by WooPayments, but Google Pay will only appear for customers who:

1. Are logged into their Google account via their browser.
2. Have a payment method added to their Google account.

Setting up Google Pay via WooPayments

↑ Back to top

To enable Google Pay:

  1. Go to Payments > Settings in your site’s dashboard.
  2. In the Express Checkouts section, check the box for Apple Pay / Google Pay.
  3. At the bottom of the page, click Save Changes.

These steps will communicate to our payment partners and Google that your site is ready to accept payments via Google Pay.

NOTE: There is no way to enable only Google Pay without Apple Pay. The two must be enabled together.

Customizing the Google Pay experience

↑ Back to top

When Google Pay is enabled, the button can appear in three places:

  • On the Checkout page.
  • On the Cart page.
  • On individual product pages.

You can customize which of these locations show the Google Pay button by going to Payments > Settings and then clicking the Customize link for Apple Pay / Google Pay in the Express Checkouts section.

Once there, you can change:

  • Where the Google Pay button shows up.
  • The text of the Google Pay button itself.
  • The size and color scheme of the Google Pay button.

Purchasing via Google Pay

↑ Back to top

By checking out with Google Pay, customers won’t need to go through the regular checkout process and spend time filling in all of their information. Everything is handled using the Google Pay interface, where customers can select their billing and shipping details, as well as which card they want to use.

Once the order is placed, WooPayments then processes the transaction and redirects the customer to the “Order Received” / “Thank you” page.

Testing Google Pay via WooPayments

↑ Back to top

NOTE: There is a known issue where Google Pay does not use the correct credentials when test mode is enabled. As a result, testing Google Pay via WooPayments is not working as expected and will be unavailable to most merchants.

As of 7 November 2023, we are still working with our payment partners to resolve this issue. We will update this document regularly with new information as it becomes available, but this GitHub issue is the best place to find the most up-to-date progress on our efforts.

In the meantime, the best way to test Google Pay is to create a separate WooPayments account via sandbox mode.

To place test orders using Google Pay:

  1. Enable test mode, if it’s not already.
  2. Add a test card to your browser’s payment methods.
    • In the Google Chrome browser, this can be done at this URL: chrome://settings/payments
  3. Follow the guidance in the Purchasing via Google Pay section.

Your test order will be visible in the dashboard after it is completed.

Feature compatibility of Google Pay

↑ Back to top

Google Pay is very similar to card payments. As a result, it is compatible with many of the same features as credit or debit card payments — but not all of them. This section will dig into how Google Pay handles many of these features.

Can I use Google Pay without taking card payments in checkout?

↑ Back to top

No, there is no way to completely disable card payments during checkout while still using WooPayments for accepting Google Pay.

Can I authorize charges with Google Pay and capture them later?

↑ Back to top

Yes. If you have checked the “Issue an authorization on checkout, and capture later” option in Payments > Settings, you can manually capture authorized charges done with Google Pay, just like other credit card transactions.

Can I issue refunds with Google Pay?

↑ Back to top

Yes. WooPayments allows you to issue refunds for Google Pay transactions just like normal transactions. This section of our Managing Money guide shows how to refund a payment.

Can I test Google Pay while in sandbox mode?

↑ Back to top

Yes; Google Pay is fully compatible with sandbox mode.

Product compatibility of Google Pay

↑ Back to top

The Google Pay integration in WooPayments is compatible with all of these product types:

1 Subscription product purchases require a customer to have or create an account. Guest users can only purchase subscription products via Apple Pay if account username and password generation settings are enabled at WooCommerce > Settings > Accounts & Privacy.
2 For these types of products, the Apple Pay button cannot be shown on the product page itself. It will appear on the cart and checkout pages, if those are enabled.

Troubleshooting Google Pay

↑ Back to top

Before troubleshooting Google Pay, first ensure that you have Log Error Messages enabled under Payments > Settings > Advanced settings. This lets you see any error messages from WooPayments under WooCommerce > Status > Logs, which could potentially be useful if you need to contact our support staff.

Google Pay button does not appear

↑ Back to top

To ensure there isn’t a problem with your browser and device combination, try using the Google Pay button on another website. You can try this demo, for example.

  • If Google Pay does not appear on another site, there is likely not an issue with WooPayments itself.
  • If Google Pay does appear on that demo, but not on your WooPayments store, this can happen for several reasons. To try to remedy the issue, please make sure:
    1. The Apple Pay / Google Pay setting is enabled under Payments > Settings.
    2. Your site is served over HTTPS.
    3. You’re testing while logged into your Google account.
    4. You have a payment method added to your Google account
    5. One of the following combinations of settings are configured in WooCommerce > Settings > Accounts & Privacy:
      • Allow customers to place orders without an account is enabled.
      • Both Allow customers to create an account during checkout and When creating an account, send the new user a link to set their password are enabled.

Google Pay button doesn’t appear in a specific location

↑ Back to top

If the Google Pay button is missing from only some locations, but not others (i.e., it appears on the Checkout page but not on the product page), this can happen for a few reasons:

  • The product may not be compatible with express checkouts.
  • Your theme may not support the necessary WooCommerce hooks, which are needed for Google Pay to show up.

Apple Pay appears instead

↑ Back to top

If you were expecting Google Pay to appear on your mobile device but see an Apple Pay button instead, this may be due to a change on Apple’s part.

In short, if you are running iOS 16 or later, Apple Pay can now be used in browsers other than Safari. As a result, you might see Apple Pay appear in some places where Google Pay would’ve previously be shown.

Unfortunately, there’s no way to revert to the old behavior.

Other issues

↑ Back to top

If you experience any other issues with Google Pay, please take the following steps:

  1. Enable test mode and logging under Payments > Settings > Advanced settings.
  2. Place a test Google Pay transaction.
  3. Under WooCommerce > Status > Logs, review the WooPayments logs.
  4. If you see any errors, please get in touch with support and provide the logs for review.