Page Summary
-
This page details the release notes for the Google Pay API, outlining changes and updates organized by date.
-
Updates include new features like promo code support, personalized buttons, and enhanced security measures like SCA.
-
The API has expanded to include a wide range of participating processors and platforms globally.
-
Google provides resources like brand guidelines, tutorials, and test card suites to aid in API integration.
-
Developers can stay informed about API changes, cryptography updates, and best practices for optimal implementation.
This page tracks updates to the Google Pay API for web.
March 01, 2026
Expanded the Gateway test cards to support billing addresses from 27 markets (previously US only). This allows merchants to test end-to-end payment flows with country-specific billing address in the TEST environment. The added markets include United Kingdom, France, Germany, Spain, Japan, Hong Kong, Brazil, and 20 other countries.
November 01, 2025
Added the FULL-ISO3166 option to the format property of the BillingAddressParameters object and introduced a new format property to the ShippingAddressParameters object. Updated the returned properties of the IntermediateAddress and Address objects to include the new iso3166AdministrativeArea parameter. This change shouldn't affect any existing implementations. Check the reference pages for more information.
October 01, 2025
Added new CONTINUE_TO_REVIEW checkoutOption. When using this option, the payment sheet button is labeled "Review Order" Check the Object reference for more information.
August 01, 2025
The createButton() API now accepts a borderButtonType property. Check the Object reference for more information.
January 01, 2025
The UX for web integrations using the authorizePayments or Dynamic Price Updates APIs APIs has been updated to match the UX for non-callback integrations, except where this UX is incompatible, for example with OFFER callbacks. As part of this change, liability shift and processor test cards are now available for web integrations using these callbackIntents.
transactionInfo.checkoutOption has been updated to give developers more control over the payment sheet. When checkoutOption is set to DEFAULT, the payment sheet will display 'Continue'. When checkoutOption is set to COMPLETE_IMMEDIATE_PURCHASE, the payment sheet will still display 'Pay'.
December 01, 2024
The border of the button when using the createButton() API is now inset. This prevents the button outline from shrinking the inner contents or being invisible during the loading state.
March 01, 2024
The createButton() API now accepts a borderRadius property. Check the Object reference for more information.
February 01, 2023
Updated card network assets for the dynamic button.
June 01, 2021
Added a tutorial and reference documentation for the Promo Codes feature, which allows merchants to update and display promo codes on the payment sheet.
February 01, 2021
Added information about buttonLocale in the ButtonOptions object to Object reference.
Added the new Google Pay Mark asset to all of the examples in UX best practices.
Added information about Strong Customer Authentication (SCA) to the PaymentDataRequest object in Tutorial, and to the countryCode and TotalPriceStatus properties of TransactionInfo in Object reference.
Added AsiaBill, bePaid, ConnexPay, EpicPay, Mixplat, Netopia, PaymentFusion, Pikassa, and PSCB to the list of participating processors.
January 01, 2021
Added the new Google Pay Mark asset to Brand guidelines.
Added CardKnox, Cloud9 Payment Gateway (C9PG), Corefy, Pay.nl, and ReePay to the list of participating processors.
December 01, 2020
Added ЮKassa, IMOJE, Modulbank, PayNearMe, QIWI, and QualPay to the list of participating processors.
Added an interactive module to customize the Google Pay button to Customize your button.
November 01, 2020
Added AllPayments, CellPoint Mobile, Evopay, and Primer to the list of participating processors.
Added instructions to configure the Google Pay API to comply with Strong Customer Authentication (SCA) to SCA and Google Pay API.
October 01, 2020
Added InPlat, IntellectMoney, Rebilly, TAS Link, and UAPay to the list of participating processors.
Added information about buttonRootNode in the ButtonOptions object to Object reference.
September 01, 2020
Added information about buttonSizeMode in the ButtonOptions object to Object reference, and a button resizing example to Live Google Pay demos.
Added Alfa-Bank Ukraine, AsiaPay, Bizzon, Credorax, and Payload to the list of participating processors.
Added a video that explains the Google Pay API in Brazilian Portuguese to Overview.
Added instructions to access our test card suite in the TEST environment to Test card suite.
June 01, 2020
Added ConcordPay, Payfacto, Radial to the list of participating processors.
Added more information about possible Merchant ID values to Tutorial.
May 01, 2020
Added instructions to update the Merchant ID value when moving to PRODUCTION to Deploy production environment.
Added Kassa to the list of participating processors.
Added more information about the isReadytoPay client reference to Reference.
Added payment flow figures to explain the relationship between Merchants, Google, and Payment Processors to Overview.
April 01, 2020
Added FreedomPay, Paymo, Oceanpayment, and PayU India to the list of participating processors.
March 01, 2020
Added 2C2P, Windcave, dLocal, and Paymentwall to the list of participating processors.
Added the allowedCreditCardsk property to the Card Parameters Request Object that allows merchants to filter out credit card transactions to Reference.
Added instructions to contact support for onboarding and technical questions using Google Pay & Wallet Console to How to get help and Troubleshooting.
Added instructions to gain production access using Google Pay & Wallet Console to Request Production Access.
Added GATEWAY parameter values to Tutorial.
February 01, 2020
Added PayOnline to the list of participating processors.
January 01, 2020
Added summary view to Brand Guidelines.
Added Paygent, Judopay, Paymark, e-SiTef - Software Express, and noon payments to the list of participating processors.
December 01, 2019
Added more information for the merchantOrigin property in the MerchantInfo request object to Reference.
Added a Basic Example, Authorize Payments Example, and Dynamic Price Update Example to Live Google Pay Demos.
Added Billing Systems, Spreedly, theMAP, and APPEX to the list of participating processors.
Added DIRECT integration requirements to Overview.
November 01, 2019
Added Tranzzo, MOBI.Money, Suntech, and Best2Pay to the list of participating processors.
Added OpenCart to the list of participating platforms.
October 01, 2019
Added instructions to enable Brazil debit and credit combo card support in the allowedCardNetworks property for the CardParameters request object to Reference.
September 01, 2019
Added NCCC, eCard, and BlueGate (NTTData) to the list of participating processors.
August 01, 2019
Updated Tutorial by adding CheckoutActivity.java to replace YourActivity.java, and PaymentsUtil.java to replace GooglePay.java.
Added new supplemental images to UX best practices.
Added instructions to customize your integration for SCA compliance to Strong Customer Authentication.
Added PayAnyWay, Paragon Payment Solutions, and Paylane to the list of participating processors.
July 01, 2019
Added Cathay United Bank, Chase Merchant Services (formerly Chase Paymentech), LogPay, Nuvei, Payler, Paymetric, and RBS to the list of participating processors.
June 01, 2019
Added new allowedCardNetworks option, INTERAC, to Tutorial.
Added a diverse set of sample token examples to Test with sample tokens.
Added more information and examples to UX best practices.
Added CardConnect, eGHL, and LogPay to the list of participating processors.
May 01, 2019
Added Braspag, Ecard, Redsys, and Worldnet to the list of participating processors.
April 01, 2019
Added Computop, MyCheck, Sipay, TPay.com, and Wirecard to the list of participating processors.
Added PayPal as a supported payment method in the type property for the PaymentMethod request object to Reference.
March 01, 2019
Added iQmetrix, Portmone, and Vindicia to the list of participating processors.
February 01, 2019
Added more information about encryption and sample payloads returned with a DIRECT integration to Test with sample tokens.
Added frequently asked product and troubleshooting questions and answers to FAQ.
Added Gestpay, iPay88, Multicarta, Square, and WayForPay to the list of participating processors.
January 01, 2019
Added Assist, GMO Payment Gateway, and Moneris to the list of participating processors.
Added localized content in the following languages: Russian, Portuguese (Brazilian), Japanese, Polish, and Chinese (Traditional).
Added examples for participating processors to the gateway and gatewayMerchantId properties for the TokenizationSpecification request object to Reference.
December 01, 2018
Added information about ECv2, an updated cryptography protocol that allows merchants to store a static, long living, Google signing key that only needs to be updated every 10 years, for DIRECT integrations to Payment data cryptography. Added information about ECv2 payload support for the Tink Library version 1.1.0 to Tink release notes.
Added Arabic to the "Buy with Google Pay" resource to Brand guidelines.
November 01, 2018
Added more information about the Google Pay mark to Brand guidelines.
Added NMI to the list of participating processors.
October 01, 2018
Added instructions for Key rotation for DIRECT integrations to Payment data cryptography.