> ## Documentation Index
> Fetch the complete documentation index at: https://developers.orchestrasolutions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GooglePay

> Accept Google Pay for fast checkout on Android and Chrome.

<Info>
  This page is part of **Supported Payment Methods**. [View all payment methods →](/guides/library/supported-payment-methods)
</Info>

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           |

```javascript theme={null}
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](https://orchestrasolutions.com/integrations/), configured in [Orchestra Portal](https://portal.orchestrasolutions.com/#/resource/paymentGateway)
* A Google Developer account with GooglePay enabled (see [GooglePay Setup](/guides/library/googlepay-setup)), configured as a GooglePay eWallet account in [Orchestra Portal](https://portal.orchestrasolutions.com/#/resource/eWalletAccount)

```javascript theme={null}
// 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

```html theme={null}
<div id="gpay-button"></div>
```

```javascript theme={null}
engine.payBy(
  [{ name: 'GooglePay', domEntitySelector: '#gpay-button' }],
  handleResult,
  { color: 'Dark', text: 'Pay' }
);
```

<Note>
  The Google Pay button renders with Google's official styling guidelines.
</Note>

## 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

| 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](https://orchestrasolutions.com/integ-type/3d-secure/).

## Address Collection

Google Pay can collect billing and shipping addresses from the customer's Google account:

```javascript theme={null}
const requiredAncillaryInfo = {
  billingInfo: {
    phoneRequired: true,
    emailAddressRequired: true,
    details: 'FULL'
  },
  shippingInfo: {
    phoneRequired: false,
    emailAddressRequired: false
  }
};

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

## Related

<CardGroup cols={2}>
  <Card title="Google Pay Setup" icon="google" href="/guides/library/googlepay-setup">
    Get Google Pay merchant credentials
  </Card>

  <Card title="Result Handling" icon="check" href="/guides/library/result-handling">
    Parse payment results
  </Card>
</CardGroup>