This page tracks updates to the Google Pay API for web.

## August 12, 2026

Feature Added the `nonce` parameter to the [`PaymentOptions`](https://developers.google.com/pay/api/web/reference/request-objects#PaymentOptions) object. When provided, Google Pay applies this Content Security Policy (CSP) nonce attribute to all dynamically injected `<style>` and `<script>` elements.

## August 05, 2026

Feature Added the `cardFundingSource` parameter to the `CardInfo` response object. This parameter returns the funding source of the selected card (`UNKNOWN`, `CREDIT`, `DEBIT`, or `PREPAID`). Merchants and PSPs sometimes need to calculate surcharge fees, discounts, or dynamic pricing based on the underlying card type (for example, applying a different fee for debit/prepaid cards versus credit cards). Google Pay provides this vital signal via `cardFundingSource`. Check the [Object reference](https://developers.google.com/pay/api/web/reference/response-objects#CardInfo) for more information.

## March 01, 2026

Feature Expanded the [Gateway test cards](https://developers.google.com/pay/api/web/guides/resources/test-card-suite#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

Feature 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](https://developers.google.com/pay/api/web/reference/client) for more information.

## October 01, 2025

Feature Added new CONTINUE_TO_REVIEW `checkoutOption`. When using this option, the payment sheet button is labeled "Review Order" Check the [Object reference](https://developers.google.com/pay/api/web/reference/request-objects#TransactionInfo) for more information.

## August 01, 2025

Feature The `createButton()` API now accepts a `borderButtonType` property. Check the [Object reference](https://developers.google.com/pay/api/web/reference/request-objects#ButtonOptions) for more information.

## January 01, 2025

Feature The UX for web integrations using the [authorizePayments](https://developers.google.com/pay/api/web/guides/tutorial#authorize-payments) or [Dynamic Price Updates](https://developers.google.com/pay/api/web/guides/tutorial#paymentdatarequest) 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](https://developers.google.com/pay/api/web/guides/resources/shift-liability-to-issuer) and [processor test cards](https://developers.google.com/pay/api/web/guides/resources/test-card-suite) are now available for web integrations using these callbackIntents.
Feature [transactionInfo.checkoutOption](https://developers.google.com/pay/api/web/reference/request-objects#TransactionInfo) 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

Change 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

Feature The `createButton()` API now accepts a `borderRadius` property. Check the [Object reference](https://developers.google.com/pay/api/web/reference/request-objects#ButtonOptions) for more information.

## February 01, 2023

Change Updated card network assets for the [dynamic button](https://developers.google.com/pay/api/web/reference/client#createButton).

## June 01, 2021

Change Added a [tutorial](https://developers.google.com/pay/api/web/guides/tutorial#promo-codes) and [reference documentation](https://developers.google.com/pay/api/web/reference/request-objects#OfferInfo) for the Promo Codes feature, which allows merchants to update and display promo codes on the payment sheet.

## February 01, 2021

Change Added information about `buttonLocale` in the `ButtonOptions` object to [Object reference](https://developers.google.com/pay/api/web/reference/request-objects#ButtonOptions).
Change Added the new Google Pay Mark asset to all of the examples in [UX best practices](https://developers.google.com/pay/api/web/guides/ux-best-practices).
Change Added information about Strong Customer Authentication (SCA) to the `PaymentDataRequest` object in [Tutorial](https://developers.google.com/pay/api/web/guides/tutorial#paymentdatarequest), and to the `countryCode` and `TotalPriceStatus` properties of `TransactionInfo` in [Object reference](https://developers.google.com/pay/api/web/reference/request-objects#TransactionInfo).
Change Added AsiaBill, bePaid, ConnexPay, EpicPay, Mixplat, Netopia, PaymentFusion, Pikassa, and PSCB to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## January 01, 2021

Change Added the new Google Pay Mark asset to [Brand guidelines](https://developers.google.com/pay/api/android/guides/brand-guidelines#google-pay-logo-mark).
Change Added CardKnox, Cloud9 Payment Gateway (C9PG), Corefy, Pay.nl, and ReePay to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## December 01, 2020

Change Added ЮKassa, IMOJE, Modulbank, PayNearMe, QIWI, and QualPay to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Feature Added an interactive module to customize the Google Pay button to [Customize your button](https://developers.google.com/pay/api/web/guides/resources/customize).

## November 01, 2020

Change Added AllPayments, CellPoint Mobile, Evopay, and Primer to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Change Added instructions to configure the Google Pay API to comply with Strong Customer Authentication (SCA) to [SCA and Google Pay API](https://developers.google.com/pay/api/web/guides/resources/sca).

## October 01, 2020

Change Added InPlat, IntellectMoney, Rebilly, TAS Link, and UAPay to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Change Added information about `buttonRootNode` in the `ButtonOptions` object to [Object reference](https://developers.google.com/pay/api/web/reference/request-objects#ButtonOptions).

## September 01, 2020

Change Added information about `buttonSizeMode` in the `ButtonOptions` object to [Object reference](https://developers.google.com/pay/api/web/reference/request-objects#ButtonOptions), and a button resizing example to [Live Google Pay demos](https://developers.google.com/pay/api/web/guides/resources/demos#button-resize-example).
Change Added Alfa-Bank Ukraine, AsiaPay, Bizzon, Credorax, and Payload to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Change Added a video that explains the Google Pay API in Brazilian Portuguese to [Overview](https://developers.google.com/pay/api/web/overview).
Change Added instructions to access our test card suite in the `TEST` environment to [Test card suite](https://developers.google.com/pay/api/web/guides/resources/test-card-suite).

## June 01, 2020

Change Added ConcordPay, Payfacto, Radial to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Change Added more information about possible Merchant ID values to [Tutorial](https://developers.google.com/pay/api/web/guides/tutorial#paymentdatarequest).

## May 01, 2020

Change Added instructions to update the Merchant ID value when moving to PRODUCTION to [Deploy production environment](https://developers.google.com/pay/api/web/guides/test-and-deploy/deploy-production-environment).
Change Added Kassa to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Change Added more information about the `isReadytoPay` client reference to [Reference](https://developers.google.com/pay/api/web/reference/client#isReadyToPay).
Change Added payment flow figures to explain the relationship between Merchants, Google, and Payment Processors to [Overview](https://developers.google.com/pay/api/web/overview).

## April 01, 2020

Change Added FreedomPay, Paymo, Oceanpayment, and PayU India to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## March 01, 2020

Change Added instructions to contact support for onboarding and technical questions using [Google Pay \& Wallet Console](https://pay.google.com/business/console?utm_source=devsite&utm_medium=devsite&utm_campaign=devsite) to [How to get help](https://developers.google.com/pay/api/web/support/how-to-get-help) and [Troubleshooting](https://developers.google.com/pay/api/web/support/how-to-get-help).
Change Added 2C2P, Windcave, dLocal, and Paymentwall to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Feature Added the `allowedCreditCardsk` property to the Card Parameters Request Object that allows merchants to filter out credit card transactions to [Reference](https://developers.google.com/pay/api/web/reference/request-objects#CardParameters).
Change Added instructions to gain production access using [Google Pay \& Wallet Console](https://pay.google.com/business/console?utm_source=devsite&utm_medium=devsite&utm_campaign=devsite) to [Request Production Access](https://developers.google.com/pay/api/web/guides/test-and-deploy/request-prod-access).
Change Added GATEWAY parameter values to [Tutorial](https://developers.google.com/pay/api/web/guides/tutorial#paymentdatarequest).

## February 01, 2020

Change Added PayOnline to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## January 01, 2020

Change Added summary view to [Brand Guidelines](https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together).
Change Added Paygent, Judopay, Paymark, e-SiTef - Software Express, and noon payments to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## December 01, 2019

Change Added more information for the `merchantOrigin` property in the `MerchantInfo` request object to [Reference](https://developers.google.com/pay/api/web/reference/request-objects#MerchantInfo).
Change Added a Basic Example, Authorize Payments Example, and Dynamic Price Update Example to [Live Google Pay Demos](https://developers.google.com/pay/api/web/guides/resources/demos).
Change Added Billing Systems, Spreedly, theMAP, and APPEX to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Change Added `DIRECT` integration requirements to [Overview](https://developers.google.com/pay/api/web/overview).

## November 01, 2019

Change Added Tranzzo, MOBI.Money, Suntech, and Best2Pay to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Feature Added OpenCart to the list of [participating platforms](https://developers.google.com/pay/api#participating-e-commerce-platforms).

## October 01, 2019

Feature Added instructions to enable Brazil debit and credit combo card support in the `allowedCardNetworks` property for the `CardParameters` request object to [Reference](https://developers.google.com/pay/api/web/reference/request-objects#CardParameters).

## September 01, 2019

Feature Added NCCC, eCard, and BlueGate (NTTData) to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## August 01, 2019

Change Updated [Tutorial](https://developers.google.com/pay/api/web/guides/tutorial) by adding `CheckoutActivity.java` to replace `YourActivity.java`, and `PaymentsUtil.java` to replace `GooglePay.java`.
Change Added new supplemental images to [UX best practices](https://developers.google.com/pay/api/web/guides/ux-best-practices).
Change Added instructions to customize your integration for SCA compliance to [Strong Customer Authentication](https://developers.google.com/pay/api/web/guides/resources/sca).
Feature Added PayAnyWay, Paragon Payment Solutions, and Paylane to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## July 01, 2019

Change Added Cathay United Bank, Chase Merchant Services (formerly Chase Paymentech), LogPay, Nuvei, Payler, Paymetric, and RBS to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## June 01, 2019

Change Added new `allowedCardNetworks` option, INTERAC, to [Tutorial](https://developers.google.com/pay/api/web/guides/tutorial#supported-card-networks).
Change Added a diverse set of sample token examples to [Test with sample tokens](https://developers.google.com/pay/api/web/guides/resources/sample-tokens).
Change Added more information and examples to [UX best practices](https://developers.google.com/pay/api/web/guides/ux-best-practices).
Change Added CardConnect, eGHL, and LogPay to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## May 01, 2019

Change Added Braspag, Ecard, Redsys, and Worldnet to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## April 01, 2019

Change Added Computop, MyCheck, Sipay, TPay.com, and Wirecard to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Change Added PayPal as a supported payment method in the `type` property for the `PaymentMethod` request object to [Reference](https://developers.google.com/pay/api/web/reference/request-objects#PaymentMethod).

## March 01, 2019

Change Added iQmetrix, Portmone, and Vindicia to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## February 01, 2019

Change Added more information about encryption and sample payloads returned with a `DIRECT` integration to [Test with sample tokens](https://developers.google.com/pay/api/web/guides/resources/sample-tokens).
Change Added frequently asked product and troubleshooting questions and answers to [FAQ](https://developers.google.com/pay/api/web/support/faq).
Change Added Gestpay, iPay88, Multicarta, Square, and WayForPay to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## January 01, 2019

Change Added Assist, GMO Payment Gateway, and Moneris to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).
Change Added localized content in the following languages: Russian, Portuguese (Brazilian), Japanese, Polish, and Chinese (Traditional).
Change Added examples for participating processors to the `gateway` and `gatewayMerchantId` properties for the `TokenizationSpecification` request object to [Reference](https://developers.google.com/pay/api/web/reference/request-objects).

## December 01, 2018

Change 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](https://developers.google.com/pay/api/web/guides/resources/payment-data-cryptography).

> [!NOTE]
> **Note:** If you've implemented support for ECv1, your implementation should continue to work. If you want to upgrade to ECv2 in production, notify your Google contact to verify your implementation.

Added information about ECv2 payload support for the Tink Library version 1.1.0 to [Tink release notes](https://github.com/google/tink/releases).

<br />

Change Added Arabic to the "Buy with Google Pay" resource to [Brand guidelines](https://developers.google.com/pay/api/web/guides/brand-guidelines#payment-buttons-assets).

## November 01, 2018

Change Added more information about the Google Pay mark to [Brand guidelines](https://developers.google.com/pay/api/web/guides/brand-guidelines).
Change Added NMI to the list of [participating processors](https://developers.google.com/pay/api#participating-processors).

## October 01, 2018

Change Added instructions for Key rotation for `DIRECT` integrations to [Payment data cryptography](https://developers.google.com/pay/api/web/guides/resources/payment-data-cryptography#key-rotation).