On this page:

Attributes

METHOD TYPEE-wallet
PAYMENTS
PAYOUTS
REFUNDS
RECURRING

Overview

GooglePay enables your customers to complete their purchases quickly and easily in apps and on the web using the payment methods saved in their Google account or on their Android device.

This guide describes how to implement GooglePay using Nuvei REST API 2.0, which currently supports non-3DS GooglePay payments.

All merchants must adhere to the GooglePay APIs Acceptable Use Policy and accept the terms defined in the GooglePay API Terms of Service.
The integration steps described below are for Testing purposes.
Contact a Nuvei Integration Specialist for assistance.

Supported Countries

Afghanistan
Aland Islands
Albania
Algeria
Andorra
Angola
Anguilla
Antarctica
Antigua and Barbuda
Argentina
Armenia
Aruba
Australia
Austria
Azerbaijan
Bahamas
Bahrain
Bangladesh
Barbados
Belarus
Belgium
Belize
Benin
Bermuda
Bhutan
Bolivia
Bonaire
Bosnia-Herzegovina
Botswana
Bouvet Island
Brazil
British Indian Ocean Territory
Brunei
Bulgaria
Burkina Faso
Cambodia
Cameroon
Canada
Cape Verde
Cayman Islands
Central African Republic
Chad
Chile
China
Chinese Taipei
Christmas Island
Close
Cocos (Keeling) Islands
Colombia
Comoros
Congo
Cook Islands
Costa Rica
Cote dIvoire
Croatia
Curacao
Curaçao
Cyprus
Czech Republic
Denmark
Djibouti
Dominica
Dominican Republic
Ecuador
Egypt
El Salvador
Equatorial Guinea
Eritrea
Estonia
Ethiopia
Falkland Islands (Malvinas)
Faroe Islands
Fiji
Finland
France
French Guiana
French Polynesia
French Southern Territories
Gabon
Gambia
Georgia
Germany
Ghana
Gibraltar
Greece
Greenland
Grenada
Guadeloupe
Guam
Guatemala
Guernsey
Guinea
Guinea-Bissau
Guyana
Haiti
Heard Island
Honduras
Hong Kong
Hungary
Iceland
India
Indonesia
Iraq
Ireland
Isle of Man
Israel
Italy
Jamaica
Japan
Jersey
Jordan
Kazakhstan
Kenya
Kiribati
Kosovo
Kuwait
Kyrgyzstan
Laos
Latvia
Lebanon
Lesotho
Liberia
Libya
Liechtenstein
Lithuania
Luxembourg
Macau
Macedonia
Madagascar
Malawi
Malaysia
Maldives
Mali
Malta
Marshall Islands
Martinique
Mauritania
Mauritius
Mayotte
Mexico
Micronesia
Moldova
Monaco
Mongolia
Montenegro
Montserrat
Morocco
Mozambique
Myanmar
Namibia
Nauru
Nepal
Netherlands
Netherlands Antilles
New Caledonia
New Zealand
Nicaragua
Niger
Nigeria
Niue
Norfolk Island
Northern Mariana Islands
Norway
Oman
Pakistan
Palau
Palestinian Territory
Panama
Papua New Guinea
Paraguay
Peru
Philippines
Pitcairn
Poland
Portugal
Puerto Rico
Qatar
Reunion
Romania
Russia
Rwanda
Saint Barthélemy
Saint Helena
Saint Kitts and Nevis
Saint Lucia
Saint Martin
Saint Pierre and Miquelon
Saint Thomas
Saint Vincent
Saint Vincent and Grenadines
Samoa
San Marino
Sao Tome and Principe
Saudi Arabia
Senegal
Serbia
Seychelles
Sierra Leone
Singapore
Slovakia
Slovenia
Solomon Islands
Somalia
South Africa
South Georgia, South Sandwich Islands
South Korea
Spain
Sri Lanka
Suriname
Svalbard and Jan Mayen Islands
Swaziland
Sweden
Switzerland
Taiwan
Tajikistan
Tanzania, United Republic of
Thailand
Timor-Leste
Togo
Tokelau
Tonga
Trinidad and Tobago
Tunisia
Turkey
Turkmenistan
Turks and Caicos Islands
Tuvalu
Uganda
Ukraine
United Arab Emirates
United Kingdom
Uruguay
Uzbekistan
Vanuatu
Vatican City
Venezuela
Vietnam
Virgin Islands
Wallis and Futuna
Western Sahara
Yemen
Zambia
Zimbabwe

Supported Currencies

GooglePay supports all currencies supported by Nuvei.

Availability

Offering your customers GooglePay as a payment option depends on the following factors:

Card Types Supported
The following card types are supported: VISA, Mastercard, Discover/Diners, AMEX and JCB.
Merchant Location
When it comes to being able to accept GooglePay transactions, the location of your business matters. Merchants in the following regions are eligible:
- United States
- Europe
- Asia Pacific
- Australia
Location of where the Customer’s Card Details are Stored
Customer compatibility depends on where the customer’s card details are stored:
- Cards stored on a Google Account:
  - Available worldwide
- Cards stored on an Android Device:
  Available to customers in the following countries:
  - United States
  - United Kingdom
  - Singapore
  - Australia
  - Hong Kong
  - Poland
  - New Zealand
  - Ireland
  - Belgium
  - Russia
  - Japan
  - Canada
  - Taiwan
  - Spain
  - Ukraine
  - Brazil
  - Czech Republic
  - Slovakia
  - France
  - South Korea

Prerequisites and Notes

This guide assumes you have completed all account setup prerequisites, and are ready to integrate GooglePay into your payment flow.
Use these gateway credentials in requests:
- For the test (sandbox) environment: gatewayMerchantId: “googletest“
- For the production environment: gatewayMerchantId: “nuveidigital“
The GooglePay Web environment must be set up according to the GooglePay guidelines:
- GooglePay Web Developer Documentation
- GooglePay Brand Promoting Guidelines
  For your domain to be verified with Google, the merchant must send Nuvei’s Integration Team screenshot(s) of your payment flow along with your domain URL
- GooglePay Test Card Suite
- GooglePay Web Integration Checklist
  
  Only some information in the pages listed are relevant to Nuvei integration. Other information is relevant only for merchants performing a direct GooglePay integration, without Nuvei.

The Google account used for testing should be linked to a relevant test card:
- GooglePay provides test cards, see GooglePay Test Card Suite for details.
- Alternatively, you can use one of the test cards listed in Testing Cards for REST 2.0.
  Test credentials and testing scenarios can be provided by Nuvei if necessary.
  You can contact Nuvei Support for any assistance.

Implementation

Follow these steps to implement GooglePay using Nuvei REST API 2.0:

Authentication.
GooglePay UI button.
Collect card details.
Integrate GooglePay for payments – Nuvei decrypts the GooglePay token.

Upon completion, customers are able to make payments using GooglePay.

When using REST 2.0, GooglePay also supports refunds.

GooglePay UI Button

Create the GooglePay UI button according to the instructions in the GooglePay for Web Payments Brand Guidelines Guide.
On your payment page, define the tokenizationSpecification constant as shown below.
(When the customer presses the GooglePay button, this parameter identifies your gateway and your site’s gateway merchant identifier.)

Example tokenizationSpecification Request
```
const tokenizationSpecification = {
  type: "PAYMENT_GATEWAY",
  parameters: {
    "gateway": "nuveidigital",
    "gatewayMerchantId": "googletest", //'googletest' for test or 'nuveidigital' for production
  }
};
```

Collect Card Details

Pressing the GooglePay button collects your customer’s card details and returns them to you as an encrypted GooglePay token.

The customer triggers the GooglePay payment flow by pressing the GooglePay button.

At this point, your customer may be asked to log in to the GooglePay account.

GooglePay displays all the cards associated with the customer’s Google account or asks the customer to “Add new credit or debit card” details.
The customer selects a payment method and GooglePay returns the encrypted GooglePay token (containing the paymentMethod class in JSON format).

Press here to see more information regarding payment data cryptography.

Payments – Nuvei Decrypts Token

The GooglePay token contains GooglePay authentication values from a successful GooglePay authentication. The merchant sends the encrypted GooglePay token as-is in a non-3DS /payments request. Nuvei decrypts the token and uses the relevant data extracted from it.

With GooglePay, REST 2.0 currently supports non-3DS integration.

Send a non-3DS POST /payments request with its mandatory parameters and include:

paymentOption class with:
- store: “none“
- networkToken class with:
  - provider: “GooglePay“
  - token: “<token received from GooglePay>“

Example GooglePay `/payments` Request

{
  "processingEntityId": "<your processingEntityid>",
  "transactionType": "Sale",
  "amount": 10,
  "currency": "EUR",
  "paymentOption": {
    "store": "none",
    "networkToken": {
      "provider": "GooglePay",
      "token": "<token received from GooglePay>"
    }
  },
  "deviceDetails": {
    "ipAddress": "<customer's IP address>"
  },
  "buyerDetails": {
    "buyerId": "<unique customer identifier in merchant system>",
    "firstName": "John",
    "lastName": "Smith",
    "email": "[email protected]",
    "phone": "6175551414",
    "billingAddress": {
      "address": "22 Main Street",
      "zip": "02460",
      "city": "Boston",
      "phone": "6175551414",
      "countryCode": "GB"
    },
    "shippingAddress": {
      "sameAsBilling": true
    }
  },
  "urlDetails": {
    "webhookUrl": "https://webhook.site/2f2334ce-d187-4e52-b71a-f93562f27a1b"
  }
}

Example Non-3DS `/payments` Response

{
  "paymentId": "7b77229fa01d478cb369809f26534345",
  "transactionId": "8110000000001701567",
  "amount": 10,
  "currency": "EUR",
  "transactionType": "Sale",
  "result": {
    "status": "approved"
  },
  "authCode": "111387",
  "partialApproval": {
    "requestedAmount": 10,
    "requestedCurrency": "EUR"
  },
  "paymentOption": {
    "networkToken": {
      "provider": "GooglePay",
      "expirationMonth": "12",
      "expirationYear": "26",
      "bin": "476134",
      "last4Digits": "1390",
      "acquirerId": "19",
      "cardType": "Debit",
      "cardBrand": "VISA"
    }
  }
}

GooglePay