Google Pay on Android without the SDK

It is possible to use Google Pay without the SDK.

About this integration

Even without the Android SDK, there is only minimal configuration required to get set up to process Google Pay. Unlike some other integrations it does not require you to sign up for a Google Developer account.

Enable Google Pay

To enable Google Pay, head over to your dashboard and then go to Connections -> Catalog -> Google Pay.

Next, fill in your merchant name and the domain name(s) where you want to use Google Pay.

Integrate Google Pay

To learn how to integrate Google Pay we recommend following Google’s tutorial. The steps below will highlight any differences and specifics for our API.

Set gateway and merchant ID

In step 2 of Google’s tutorial you are instructed to request a payment token for your provider. In our case, the value for gateway needs to be set to gr4vy, and the value of gatewayMerchantId needs to be set to app.gr4vy.sandbox.[gr4vy_id].[merchant_account_id] for your sandbox environment, and app.gr4vy.[gr4vy_id].[merchant_account_id] in production.

private static JSONObject getGatewayTokenizationSpecification() throws JSONException {
    return new JSONObject() {{
            put("type", "PAYMENT_GATEWAY");
            put("parameters", new JSONObject() {{
            put("gateway", "gr4vy");
            put("gatewayMerchantId", "app.gr4vy.sandbox.example.default");
        }});
    }};
}

The Gr4vy ID is the unique identifier for your instance. Together with the environment (sandbox or production) it is used to connect to the right APIs.

Create a transaction

In step 9 of Google’s tutorial, you will have a paymentData that needs to be sent to the gateway. You can send this object to our POST /transactions endpoint.

curl -X POST http://api.sandbox.example.gr4vy.app/transactions \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi..." \
  -H "Content-Type: application/json" \
  -d "{
        "amount": 1299,
        "currency": "AUD",
        "country": "AU",
        "payment_method": {
          "token": paymentData.paymentMethodData.tokenizationData.token,
          "card_suffix": "1234", # Can be extracted from paymentData.paymentMethodData.info.cardDetails
          "card_scheme": paymentData.paymentMethodData.info.cardNetwork,
          "redirect_url": "https://example.com/callback"
        }
      }"

We strongly recommend always providing a redirect_url, just in case any connection is configured to use 3-D Secure.

This URL will be appended with both a transaction ID and status (e.g. https://example.com/callback?transaction_id=123 &transaction_status=capture_succeeded) after 3-D Secure has been completed.

To learn how to integrate Google Pay we recommend following Google’s tutorial. The steps below will highlight any differences and specifics for our API.

Set gateway and merchant ID

private static JSONObject getGatewayTokenizationSpecification() throws JSONException {
    return new JSONObject() {{
            put("type", "PAYMENT_GATEWAY");
            put("parameters", new JSONObject() {{
            put("gateway", "gr4vy");
            put("gatewayMerchantId", "app.gr4vy.sandbox.example.default");
        }});
    }};
}

The Gr4vy ID is the unique identifier for your instance. Together with the environment (sandbox or production) it is used to connect to the right APIs.

Create a transaction

In step 9 of Google’s tutorial, you will have a paymentData that needs to be sent to the gateway. You can send this object to our POST /transactions endpoint.

curl -X POST http://api.sandbox.example.gr4vy.app/transactions \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi..." \
  -H "Content-Type: application/json" \
  -d "{
        "amount": 1299,
        "currency": "AUD",
        "country": "AU",
        "payment_method": {
          "token": paymentData.paymentMethodData.tokenizationData.token,
          "card_suffix": "1234", # Can be extracted from paymentData.paymentMethodData.info.cardDetails
          "card_scheme": paymentData.paymentMethodData.info.cardNetwork,
          "redirect_url": "https://example.com/callback"
        }
      }"

We strongly recommend always providing a redirect_url, just in case any connection is configured to use 3-D Secure.

This URL will be appended with both a transaction ID and status (e.g. https://example.com/callback?transaction_id=123 &transaction_status=capture_succeeded) after 3-D Secure has been completed.

In React Native you can use any Google Pay integration, together with your merchant identifier. One of the easiest solutions is to use a library like React Native Google Pay to get a Google Pay token.

On initialization, any of these libraries will require you to set the Google Pay merchant identifier and our gateway ID. You should set the gateway value to gr4vy and the gatewayMerchantId to your environment, e.g. app.gr4vy.sandbox.[gr4vy_id].[merchant_account_id].

import { GooglePay } from 'react-native-google-pay';

const allowedCardNetworks = ['VISA', 'MASTERCARD'];
const allowedCardAuthMethods = ['PAN_ONLY', 'CRYPTOGRAM_3DS'];

const requestData = {
  cardPaymentMethod: {
    tokenizationSpecification: {
      type: 'PAYMENT_GATEWAY',
      gateway: 'gr4vy',
      gatewayMerchantId: 'app.gr4vy.sandbox.example.default',
    },
    allowedCardNetworks,
    allowedCardAuthMethods,
  },
  transaction: {
    totalPrice: '10',
    totalPriceStatus: 'FINAL',
    currencyCode: 'AUD',
  },
  merchantName: 'Example Merchant',
};

// Set the environment before the payment request
GooglePay.setEnvironment(GooglePay.ENVIRONMENT_TEST);

The Gr4vy ID is the unique identifier for your instance. Together with the environment (sandbox or production) it is used to connect to the right APIs.

Once the user has approved the payment, your application will receive a Google Pay token from the library.

You can pass this library to our server for processing.

GooglePay.requestPayment(requestData)
    .then((token: string) => {
      return fetch('https://api.example.gr4vy.app/transactions', {
      method: 'POST',
      headers: {
        "Authorization": "Bearer [TOKEN]"
      },
      body: {
        amount: 1299,
        currency: "AU",
        currency: "AUD",
        payment_method: {
          method: "googlepay",
          token: token,
          redirect_url: 'https://example.com/callbacl'
        }
      }
    })
    .then(res => res.json())
    .then(successHandler)
    .catch(errorHandler)
    })
    .catch((error) => console.log(error.code, error.message));

We strongly recommend always providing a redirect_url, just in case any connection is configured to use 3-D Secure. This can be set to an application URL or URN if needed.

This URL will be appended with both a transaction ID and status (e.g. https://example.com/callback?transaction_id=123 &transaction_status=capture_succeeded) after 3-D Secure has been completed.

Test Google Pay

Please follow the Google Pay documentation with further guides on how to add test cards for use in a sandbox environment.

Getting Started

Payments

Cloud Vault

Dashboard

Features

API

Google Pay on Android without the SDK

About this integration

Enable Google Pay

Integrate Google Pay

Set gateway and merchant ID

Create a transaction

Set gateway and merchant ID

Create a transaction

Test Google Pay

Getting Started

Payments

Cloud Vault

Dashboard

Features

API

​About this integration

​Enable Google Pay

​Integrate Google Pay

​Set gateway and merchant ID

​Create a transaction

​Set gateway and merchant ID

​Create a transaction

​Test Google Pay

About this integration

Enable Google Pay

Integrate Google Pay

Set gateway and merchant ID

Create a transaction

Set gateway and merchant ID

Create a transaction

Test Google Pay