• Guides
Event date
21 December 2023

Google Pay™ Integration

Integration Guide for Merchants & Partners
How it works
  • Customer clicks the Google Pay button. Using the Google API, your system initiates the Google Pay request identifying Till Payments as your payment gateway, passing your Till Payments merchant ID as the gateway merchant ID.

  • Customer confirms the payment. The Google API contacts Google Pay services to retrieve the consumer’s payment parameters.

  • Google creates encrypted payment data using the gateway-specific key that is supplied in the Wallet request and includes it in the Google API response. Google Pay callback returns the encrypted payment data.

  • Your system prepares the Google Pay response information for submission to the Till Payments service. Till Payments sends the authorization request to the Payment network. The payment network processes the request and creates the issuer authorization request.

  • The issuer processes the request from the payment network. The issuer looks up the payment information and returns an approved or declined authorization message to the payment network.

  • The payment network returns the authorization response to Till Payments. Till Payments returns the authorization response to your system.

  • Your system returns the authorization response to the payment application, so the Customer knows the transaction is either successful or unsuccessful.


The following topics describes integrating Google Pay with a website or web application.

Sign up with Google PayTM

Before you begin, set up a Merchant account with the Google Pay and proceed integrating in reference to the below links:

·       Google Pay Web developer documentation

·       Google Pay Web integration checklist

·       Google Pay Web brand guidelines

Set up Merchant account

To start accepting Google Pay payments, you will need to be registered with Till Payments as one of our merchants. Once you are registered, we will provide you with two values gateway and gatewayMerchantId for you to request a payment token from Google Pay. Set Till Payments as your gateway and use merchantId that we will provide you as your gatewayMerchantId. You may then pass the payment token information to Till Payments to process the payment.

Supported Google Pay Experiences

Card Schemes supported

  • Visa

  • Mastercard

  • Diners

  • Discover

  • Amex

  • JCB

Card authentication methods supported


This is used for cards stored against your Google account. To get protection against chargebacks you

might need to consider enabling 3DSecure


This authentication method is associated with cards stored as Android device tokens. Returned payment data includes a 3-D Secure (3DS) cryptogram generated on the device.


High level flow


When a customer on your website presses the payment button, submit a payment data request to the Google API with the following parameters:

For example:

The Google Pay API will return a Payment Method Token that contains the payment data of the customer. This is an example of the Payment Method Token structure that will be returned.


The resulting token from the Google Pay must be submitted in the tokenData element of the /payment endpoint, with the walletType GOOGLE_PAY


Endpoint: https://api.tillpayments.com/payment


There are two final steps before your platform is fully approved for production.

·       Test and Certify with Google
·       Test with Till Payments

Certify with Google

Before your platform can fully integrate with Google, the Google Pay team must clear your final integration for production. After you have completed each part of the integration checklist, which includes testing your integration, navigate to your Google Pay Business console to get started.

Certify with Till Payments

To ensure that we can decrypt your Google Pay Token, test the flow from creating the Google Pay Token to using that token to create a payment with us.


Upon successful completion of the certification with Google and Till Payments, Till will provide the Prod Merchant API key, gatewayId and gatewayMerchantId for transaction initiation in Prod.