Overview

This guide provides information to help you quickly integrate Google Paytm acceptance into your Androidtm application. Adding Google Pay to your payment methods allows customers to use their stored Google Pay data to quickly and securely pay for goods and services.

Requirements

To integrate Google Pay acceptance, you need:

  • An Android device with Google Play services version 16.0.0 or greater installed.
  • An Android application that integrates the following APIs:
  • A CardConnect merchant account configured to accept Google Pay payments. 

    Notes:
    • Google Pay acceptance is only supported for merchants boarded to the RapidConnect platform.
    • Supported card networks and authorization methods are dependent on your CardConnect merchant account configuration.

By integrating the Google Pay API, you accept the Google Pay API Terms of Service.

Developer Resources

CardConnect Sample App

CardConnect provides a sample application that includes a working demo of our Google Pay tokenization using CardSecure. 

The CardConnect Google Pay Demo App is available on Google Play.

Get it on Google Play

Google Developer Resources

In addition to this guide, review the following Google Developer resources.

Google ResourceDescription
Google Pay API Android OverviewProvides an overview of the Google Pay API for Android and participating processors.
Google Pay Brand GuidelinesProvides guidelines for integrating Google Pay with your app.
Google Pay API Android Integration TutorialProvides detailed information for integrating the Google Pay API with your Android app.

This tutorial is referenced in the following procedures in this guide.
Google Pay Integration ChecklistProvides a checklist to verify your Google Pay integration.

How it Works

By integrating Google Pay acceptance and CardSecure tokenization into your mobile app, you enable your customers to pay quickly and securely using the payment data stored in a Google Pay wallet. CardSecure handles the decryption and tokenization of the customer's payment data (the Google Pay response object). Integrating Google Pay enables you to provide a quick, seamless checkout experience to millions of Google Pay users. 

All transactions are available in CardPointe for reporting. Additionally, integrating the CardPointe Gateway API allows you to take advantage of the complete set of transaction and reporting features of the CardPointe Gateway.

Developing your App

First, you build or upgrade an application, using the Google Pay API to integrate Google Pay acceptance. During that process, you configure some key parameters to integrate CardSecure's tokenization method. See Integrating Google Pay Acceptance for more information. When your development is complete, you certify the app with Google to make it available to your customers.

Payment Process

  1. When a customer selects Google Pay as their payment method, your application requests that customer's encrypted payment card or wallet information. 
  2. Your app then passes that encrypted data to CardSecure, which decrypts and tokenizes the data. 
  3. Your app receives the tokenized data, and then passes it to the CardPointe Gateway in an authorization request.
  4. Your app then receives a response from the CardPointe Gateway, completing the transaction.

Integrating the Google Pay API

To integrate Google Pay acceptance into your application, perform the steps provided in the Google Pay API documentation, using the following supplemental information to integrate the Google Pay API and CardSecure with your app:

  1. When you choose a payment tokenization method, do the following to connect to CardSecure:
    1. For the Gateway parameter replace example with cardconnect
    2. For the GatewayMerchantID parameter, replace exampleGatewayMerchantId with your CardConnect merchant ID (MID).
  2. When you define supported payment card networks, do the following:
    1. For getAllowedCardNetworks, specify the card types that your merchant account is configured to accept.
    2. For getAllowedAuthCardMethods, specify both PAN_ONLY and CRYPTOGRAM_3DS.
  3. When you describe your allowed payment methods, do the following:
    1. For getBaseCardPaymentMethod, specify
       cardPaymentMethod.put("tokenizationSpecification", getTokenizationSpecification());.
  4. Configure your app to handle the response object. See Tokenizing Google Pay Data for more information.

Tokenizing Google Pay Data

When your application receives the encrypted Google Pay payload, you pass the data to CardSecure, which decrypts and tokenizes the data.

Your application must submit a URL-encoded request to CardSecure, using the CR action code and the string returned by Google Pay.

For example:

http:<host>:<port>/cardsecure/cs?action=CR&data=<Google Pay payload>

You can add the type= parameter to your request to receive a response in either JSON or XML. 

For example:

http:<host>:<port>/cardsecure/cs?action=CR&data=<Google Pay payload>&type=json

returns

processToken( { "action" : "CR", "data" : "<token>" } )

Processing a Payment

Once you receive a token from CardSecure, you can pass the token to the CardPointe Gateway in an authorization request. 

You use the CardPoint Gateway API to make a request to the auth endpoint. CardConnect provides sample applications to simplify your integration. See the REST client tool kit for more information and examples. 

See the CardPointe Gateway API Developer documentation for detailed information on the authorization request and response data.

Support

For assistance with your CardConnect merchant account, or integrating CardSecure and the CardPointe Gateway, contact ISVintegarations@cardconnect.com.

For assistance with integrating the Google Pay API, see the Google Pay API Troubleshooting page or complete the Google Pay API Integration Support Request Form.

Trademark Information

AndroidTM and Google PayTM are trademarks of Google LLC.

Google PlayTM and the Google Play logo are trademarks of Google LLC.

CardSecureTM is a registered trademark of CardConnect.