> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ixopay.ferndocs.com/developer-hub/documentation/adapters/google-pay™/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server.

# GooglePay™

This page provides an overview of the payments methods provided by the GooglePay™ adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating GooglePay™ within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

GooglePay is not an adapter itself, but a common type of payment supported by some listed adapters.

Only GooglePay protocol version 2 (ECv2) is supported.

## Prerequisites

You can use GooglePay in your Android app or on your website.

To integrate GooglePay in your Android app please refer to the following links:

* [Google Pay Android developer documentation](https://developers.google.com/pay/api/android/overview)
* [Google Pay Android integration checklist](https://developers.google.com/pay/api/android/guides/test-and-deploy/integration-checklist)
* [Google Pay Android brand guidelines](https://developers.google.com/pay/api/android/guides/brand-guidelines)

To integrate GooglePay in your website please refer to the following links:

* [Google Pay Web developer documentation](https://developers.google.com/pay/api/web/overview)
* [Google Pay Web integration checklist](https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist)
* [Google Pay Web brand guidlines](https://developers.google.com/pay/api/web/guides/brand-guidelines)

## Transaction Processing

For GooglePay transactions acquire a Payment Token through your Android app, or on your website.

Use the following parameters when sending a request to Google and replace `YOUR_MERCHANT_ID` with the GUID of your merchant:

```text
gateway = "YOUR_GATEWAY_PARAMETER"
gatewayMerchantId = "YOUR_MERCHANT_ID"
```

If you are unsure about your gateway parameter, please contact your account manager.

The resulting token must be submitted in the `transactionToken` element of the Debit/Preauthorize, prefixed with `googlepay:`

Example XML:

```xml
<transactionToken>
  googlepay:{"signature":"...","intermediateSigningKey":{"signedKey":"{\"keyValue\":\"...\",\"keyExpiration\":\"...\"}","signatures":["..."]},"protocolVersion":"ECv2","signedMessage":"{\"encryptedMessage\":\"...\",\"ephemeralPublicKey\":\"...\",\"tag\":\"...\"}"}
</transactionToken>
```

Example JSON:

```json
{
  "transactionToken": "googlepay:{\"signature\":\"...\", ...}\"}",
  ...
}
```

## Card Parameters

A billing address is not required for processing transactions, therefore no billing address parameters need to be given with a card.

### Supported Card Authentication Methods

* `PAN_ONLY`
* `CRYPTOGRAM_3DS`

### Supported Card Networks

* `AMEX`
* `DISCOVER`
* `INTERAC`
* `JCB`
* `MASTERCARD`
* `VISA`