Google Pay Drop-in integration

On this page, you can find additional configuration for adding Google Pay to your Drop-in integration.

When shoppers select Google Pay, Drop-in presents the Google Pay payment sheet where shoppers choose a card they want to use. If shoppers select a card that requires 3D Secure authentication, Drop-in also handles redirecting shoppers to another website to complete the verification.

Before you begin

This page assumes you've already:

• Built a Drop-in integration.
• Added Google Pay in your Customer Area.

To be able to accept live Google Pay payments, you must complete all of the steps in Before you go live.

API reference

You don't need to send additional fields for Google Pay. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:

• /sessions: This is the default with Components v5.0.0 or later.
• /payments: If you implemented an advanced use case, or integrated Components before v5.0.0.

Drop-in configuration

Load the Google Pay API JavaScript library

We recommend that you preload the the Google Pay API JavaScript library, by including the
following script in your checkout page:

<script src="https://pay.google.com/gp/p/js/pay.js"></script>

Required configuration

Select which endpoint you're integrating:

• /sessions
• /payments

This is the default with Components v5.0.0 or later.
There's no additional configuration you need to include for Google Pay.

If you implemented an advanced use case, or integrated Components before v5.0.0.

Parameter name	Required	Description
amount.value		The value of the payment, in minor units.
amount.currency		The currency code of the payment.
countryCode		The two-letter country code of your merchant account.
environment		Set to PRODUCTION when you're ready to accept live payments. The default value is TEST.
configuration.gatewayMerchantId	Required for v3.12.0 or earlier	The name of your Adyen merchant or company account.
configuration.merchantId	Required for v3.12.0 or earlier	Your Google Merchant ID.
allowedCardNetworks	Required for v3.19.0 or earlier	Specifies the card networks you support. Use the values from Google Pay.

The following example shows how to configure Drop-in if you're using v3.12.0 or earlier.

https://docs.adyen.com/payment-methods/google-pay/web-component#google-pay-configuration

Google Pay configuration

const googlePayConfiguration = {
    amount: {
        value: 1000,
        currency: "EUR"
    },
    countryCode: "NL",
    //Set this to PRODUCTION when you're ready to accept live payments
    environment: "TEST",
    //Reqired for v3.12.0 or earlier
    configuration: {
        gatewayMerchantId: "YOUR_ADYEN_COMPANY_OR_MERCHANT_ACCOUNT",
        //Your Google Merchant ID as described in https://developers.google.com/pay/api/web/guides/test-and-deploy/deploy-production-environment#obtain-your-merchantID
        merchantId: "YOUR_GOOGLE_MERCHANT_ID"
    },
    //Required for v3.19.0 or earlier. Use values from https://developers.google.com/pay/api/web/guides/tutorial#supported-card-networks
    allowedCardNetworks: ["AMEX", "MASTERCARD", "VISA"]
};

Include the googlePayConfiguration object when creating a configuration object:

https://docs.adyen.com/payment-methods/google-pay/web-component#-code-adyencheckout-code-configuration

AdyenCheckout configuration

const configuration = {
  // ...  other required configuration
  paymentMethodsConfiguration: {
    paywithgoogle: googlePayConfiguration
  }
};

Optional configuration

You can also configure:

• The merchant name that appears on the Google Pay payment sheet.
• The Google Pay button appearance.
• Your payment requirements.
• The card types and payment methods that you accept.
• Event handlers to use.

Merchant info

Configure the merchant name rendered in the payment sheet. See MerchantInfo for more details.
If you specify configuration.merchantName, then you must also specify configuration.merchantId and configuration.gatewayMerchantId.

Button options

Configure the Google Pay button. See ButtonOptions for more details.

Payment data

Configure your payment requirements. See PaymentDataRequest for more details.

Card parameters

Configure accepted card types. See Card Parameters for more details.

Payment method support

Specify which payment methods are supported. See IsReadyToPayRequest for more details.

Events

The following event handlers are supported for Google Pay.

Recurring payments

To make recurring Google Pay payments, you first need to create a shopper token and then make subsequent recurring transactions with the token.

Refer to Tokenization for more information and detailed instructions.

Test and go live

To test Google Pay, you have two different options:

• Login to a Google account and create a Google Pay wallet with valid card details.
• Use a sample card from Google's test card suite .

You can check the status of a Google Pay test payment in your Customer Area > Transactions > Payments.

For more information, see Google Pay's test environment setup for Web.

Before you go live

1. Make sure your API credential has the API Clientside Encryption Payments role. Check this in your live Customer Area or ask your Admin user to verify.
2. Contact our Support Team and submit a request to configure your Google Pay merchantID .
3. Complete all of the steps in the Google Pay API deploy to production documentation for Web.

In the live environment, note that Google Pay will only be available if:

• The shopper is logged in to their Google account.
• The shopper has at least one valid payment method on their Google Pay account.

See also