With Google Pay, your customers can easily make payments on your app or website using any credit or debit card linked to their Google Account. This includes cards from services like Google Play, YouTube, Chrome, or any Android device.

When a customer makes a payment using Google Pay, it displays a payment sheet, allowing them to choose their preferred card and confirm their purchase securely.

Before you start

To initiate the Google Pay payment processing, the initial step involves the Set up of Google Pay. After successfully setting it up, you gain the capability to incorporate the Google Pay button into your checkout page and securely request encrypted payment details from your customers.

Before going live, you must maintain strict compliance with the stipulations outlined in Google Pay API Acceptable Use Policy.

Google Pay supports a range of web browsers, including Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera, and UCWeb UC Browser.

Enable Google Pay

To begin this process, you must be logged in using a Google Developer account. 

This entails completing the registration on the Google Pay & Wallet Console and select “Gateway” as your Google Pay API Integration Type.

Once this process is finalized, you will gain the ability to initiate a payment.

Make a payment

First, you should initiate the creation of the order.

Upon generating the order request, make sure to include “XPAY” as a payment method. 

Following this, proceed to make the payment request as per the following detailed message.

The message below represents the GooglePay Payment Request:

Header Parameters:

Request Parameters:

Here’s a sample of a Google Pay transaction:

{
 "info": {
 "deviceInfo": {
 "browserAcceptHeader": "application/json, text/plain, */*",
 "browserJavaEnabled": "false",
 "browserLanguage": "en",
 "browserColorDepth": "24",
 "browserScreenHeight": "1080",
 "browserScreenWidth": "1920",
 "browserTZ": "-60",
 "browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36",
 "geoLocalization": "Lat: 38.7350528 | Long: -9.2143616",
 "systemFamily": "Windows",
 "systemVersion": "Windows",
 "deviceID": "498bfd4c3a3645b38667a7037b616c18",
 "applicationName": "Chrome",
 "applicationVersion": "106"
 },
 "customerInfo": [
 {
 "key": "customerName",
 "value": "Test Name"
 },
 {
 "key": "customerEmail",
 "value": email@provider.com
 }
 ]
 },
 "tokenInfo": {
 "tokenType": "googlePay",
 "value": "eyJzaWduYXR1cmUiOiJNRVVDSVFDVXkvSU1SVEErRk9UbjNhdERHQlQvVHZYOWZQdE8wSFhydGVBcWNJb9In0="
 }
}

After the payment is processed, you will receive a response indicating the transaction status.

Additionally, you can perform a “Get Status” operation to check the status at any time.

The Authorization HTTP header is set to the Bearer token as it was used in the initial Checkout.

GET {transactionID}/status

Request URL:

https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/status

Request Headers:

Authorization: ‘Bearer <AuthToken>’ 
X-IBM-Client-Id: ‘<ClientId>’ 
Content-Type: application/json

A successful technical response comprises of an HTTP-200 status and a returnStatus.statusCode=”000″.

Here are some examples of the possible result codes: