Skip to main content
This page is part of Supported Payment Methods. View all payment methods →
Google Pay enables fast payments using cards stored in the customer’s Google account. Available on Android devices and Chrome browser on desktop.

Availability

Google Pay is available on Chrome browsers and Android devices.
PlatformAvailability
Chrome (desktop)Yes
Chrome (Android)Yes
Safari/Firefox/EdgeNo
Android appsYes
iOSNo
const available = await engine.checkAvailability();
if (available.includes('GooglePay')) {
  // Show Google Pay button
}

Requirements

GooglePay requires:
// Server-side session creation
const session = {
  operation: 'CHARGE',
  paymentGatewayAccountId: 'your-psp-account',
  allowedeWalletAccountIds: ['your-googlepay-account'],
  allowedBrands: ['VISA', 'MASTERCARD', 'AMEX'],
  amount: 25.00,
  currencyCode: 'USD',
  countryCode: 'US',
  mode: 'LIVE'
};

Button Setup

<div id="gpay-button"></div>
engine.payBy(
  [{ name: 'GooglePay', domEntitySelector: '#gpay-button' }],
  handleResult,
  { color: 'Dark', text: 'Pay' }
);
The Google Pay button renders with Google’s official styling guidelines.

How It Works

  1. Customer clicks the Google Pay button
  2. Google Pay payment sheet appears
  3. Customer selects a saved card or adds a new one
  4. Customer authenticates (fingerprint, PIN, or password)
  5. Google returns encrypted payment data to Orchestra
  6. Orchestra processes the payment through your PSP
  7. On completion, results are returned to the client, ready to be sent to your server for validation

Supported Operations

OperationSupportedDescription
CHARGEYesProcess payment immediately
TOKENIZEYesStore payment method for future use
CHARGE_AND_TOKENIZEYesProcess payment and store for future

3D Secure

GooglePay 3DS support depends on the device:
  • Desktop browser: Not considered 3DS (no two-factor authentication)
  • Mobile device: 3DS-enabled via two-factor authentication (fingerprint, PIN, or password)
Orchestra automatically passes the 3DS authentication data to your PSP if the Orchestra integration to your PSP supports 3DS.

Address Collection

Google Pay can collect billing and shipping addresses from the customer’s Google account:
const requiredAncillaryInfo = {
  billingInfo: {
    phoneRequired: true,
    emailAddressRequired: true,
    details: 'FULL'
  },
  shippingInfo: {
    phoneRequired: false,
    emailAddressRequired: false
  }
};

const engine = new eWallet.Engine(sessionToken, requiredAncillaryInfo);