GooglePay

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.

Platform	Availability
Chrome (desktop)	Yes
Chrome (Android)	Yes
Safari/Firefox/Edge	No
Android apps	Yes
iOS	No

const available = await engine.checkAvailability();
if (available.includes('GooglePay')) {
  // Show Google Pay button
}

Requirements

GooglePay requires:

A payment gateway (PSP) account from one of our supported payment gateways, configured in Orchestra Portal
A Google Developer account with GooglePay enabled (see GooglePay Setup), configured as a GooglePay eWallet account in Orchestra Portal

// Server-side session creation
const session = {
  operation: 'CHARGE',
  paymentGatewayAccountId: 'yourPspAccount',
  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

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

Supported Operations

Operation	Supported	Description
`CHARGE`	Yes	Process payment immediately
`TOKENIZE`	Yes	Store payment method for future use
`CHARGE_AND_TOKENIZE`	Yes	Process 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);

Google Pay Setup

Get Google Pay merchant credentials

Result Handling

Parse payment results

Start Here

Beyond the Quickstart

Concepts

Orchestra Payments Library Guides

Orchestra REST API Guides

Utilities

Merchant Account Setup

Support

Changelog

Availability

Requirements

Button Setup

How It Works

Supported Operations

3D Secure

Address Collection

Google Pay Setup

Result Handling

​Availability

​Requirements

​Button Setup

​How It Works

​Supported Operations

​3D Secure

​Address Collection

​Related

Google Pay Setup

Result Handling

Availability

Requirements

Button Setup

How It Works

Supported Operations

3D Secure

Address Collection

Related