This page tracks updates to the Google Pay API for Android.
April 27, 2026
Added support for Dynamic Price Updates via callbacks in the Google Pay API for Android. This feature allows merchants to update the payment sheet dynamically based on user actions (e.g., changing shipping address or shipping option). This requires version 20.0.0 or higher of the com.google.android.gms:play-services-wallet library. New objects introduced include PaymentDataCallbacks, PaymentDataRequestUpdate, IntermediatePaymentData, and PaymentAuthorizationResult.
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 a new format property, iso3166AdministrativeArea. This change should be non-breaking for existing implementations. Check the reference pages for more information.
October 01, 2025
Added new API method getPaymentMetdata to fetch metadata related to a user's preferred payment method to enhance their pre-checkout experience. Please contact us for more information on this feature.
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.
Added support for new PIX and EWALLET button types to the Pay Button API
July 01, 2024
The PayButton API now offers a personalization feature that displays the user's card network (e.g., Visa, Mastercard) and the last four digits of their card on the following Google Pay payment buttons. This enhancement is available only to users who have an eligible card linked to their Google Pay account.
May 01, 2024
Version 19.4.0 of the Play Services Wallet library sets the minimum SDK version to 21 and includes internal dependency updates.
February 01, 2024
Released version 19.3.0 of the Play Services Wallet library, which adds support for the new Activity Result API on Android with the introduction of new contracts to handle loadPaymentData task results. Get started with the API by creating activity result launchers using the GetPaymentData and GetPaymentDataResult contracts.
December 01, 2023
Released version 19.3.0-beta01 of the Play Services Wallet library, which adds support for the new Activity Result API on Android with the introduction of new contracts to handle loadPaymentData task results. Get started with the API by creating activity result launchers using the GetPaymentData and GetPaymentDataResult contracts. This version also deprecates the AutoResolveHelper#resolveTask(Task<TResult>, Activity, int) method. Use the new Activity Result API contracts introduced in this release instead.
September 01, 2023
Released version 19.2.1 of the Play Services Wallet library, which updates the PayButton API to fall back to a static button asset for users with Google Play services version less than 23.21.0.
June 01, 2023
Updated the PayButton API for Android with button text the same size as the "GPay" logo, adjustable button margins to the minimum and maximum button heights, and a configurable corner radius to match your UI design.
April 01, 2023
Added a PayButton API for Android to generate Google Pay payment buttons styled with the latest Google Pay branding. See developer documentation for instructions to update to the new payment button
February 01, 2023
Added a Gateway Test Cards to facilitate end-to-end testing. Merchants can select one of these cards to get a token they can send to a processor's test environment and recieve appropriate responses. Refer to the test card suite documentation.
February 01, 2021
Added the new Google Pay Mark asset to all of the examples in UX best practices.
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.
November 01, 2020
Added instructions to configure the Google Pay API to comply with Strong Customer Authentication (SCA) to SCA and Google Pay API.
Added AllPayments, CellPoint Mobile, Evopay, and Primer to the list of participating processors.
October 01, 2020
Added InPlat, IntellectMoney, Rebilly, TAS Link, and UAPay to the list of participating processors.
Added instructions on how to use our TEST merchant ID value to test decryption with the TINK library to Payment data cryptography.
September 01, 2020
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.
Added sample code and examples in the Kotlin programming language to Tutorial.
Added Alfa-Bank Ukraine, AsiaPay, Bizzon, Credorax, and Payload to the list of participating processors.
June 01, 2020
Added ConcordPay, Payfacto, Radial to the list of participating processors.
May 01, 2020
Added more information about the isReadytoPay client reference to Reference.
Added payment flow figures that explain the relationship between Merchants, Google, and Payment Processors to Overview.
Added Kassa to the list of participating processors.
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 instructions to gain production access using registering with Google Pay & Wallet Console to Request production access.
Added the allowedCreditCards property to the CardParameters 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 gateway parameter values to Tutorial.
February 01, 2020
Added PayOnline to the list of participating processors.
January 01, 2020
Added a 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 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
Added new supplemental images to UX best practices.
Updated Tutorial by adding CheckoutActivity.java to replace YourActivity.java, and PaymentsUtil.java to replace GooglePay.java.
Removed the merchantId property from the example MerchantInfo object.
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 a diverse set of sample token examples to Test with sample tokens.
Added CardConnect, eGHL, and LogPay to the list of participating processors.
Added new allowedCardNetworks option, INTERAC, to the Tutorial.
Added more information and examples to UX best practices.
May 01, 2019
Added Braspag, Ecard, Redsys, and Worldnet to the list of participating processors.
April 01, 2019
Added PayPal as a supported payment method in the type property for the PaymentMethod request object to Reference.
Added Computop, MyCheck, Sipay, TPay.com, and Wirecard to the list of supported gateways.
March 01, 2019
Added iQmetrix, Portmone, and Vindicia to the list of participating processors.
February 01, 2019
Added frequently asked product and troubleshooting questions and answers to FAQ.
Added more information about encryption and sample payloads returned with a DIRECT integration to Test with sample tokens.
Added Gestpay, iPay88, MultiCarta, Square, and WayForPay to the list of participating processors.
January 01, 2019
Added localized content in the following languages: Russian, Portuguese (Brazilian), Japanese, Polish, and Chinese (Traditional).
Added examples for participating processors to the gateway table and gatewayMerchantId properties for the TokenizationSpecification Request Object to Reference.
Added Assist, GMO Payment Gateway, and Moneris to the list of supported gateways.
December 01, 2018
Added information about ECv2, an updated cryptography protocol that allows merchants to store a static, long-term, 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 for the "Buy with Google Pay" resource to Brand guidelines.
November 01, 2018
Added NMI to the list of participating processors.
Added more information about the Google Pay mark to Brand guidelines.
October 01, 2018
Added instructions for key rotation for DIRECT integrations to Payment data cryptography.
September 01, 2018
Added information about APIv2 to GitHub code sample.
August 01, 2018
Added information about the new version of Google Pay API, APIv2, to Update to latest version.