Google Pay Module

See the [Google Pay^TM Feature Page] for more information and options on how to integrate Google Pay with BR-DGE.

The Google Pay module enables payments using the [Google Pay^TM for Payments - Web API]. This works by integrating with Google Pay to generate a single-use Google Pay Nonce, which is used as a payment instrument via the [BR-DGE REST API].

Implementation

BR-DGE integrates with Google Pay with Payment Service Providers (PSPs).

This means BR-DGE registers with Google Pay and acts as a reseller so we can do transactions on your behalf.

To use this functionality, you will need to:

[Add the Google Pay Module to Your App].
Receive the Google Pay Nonce.
Send the Google Pay Nonce to the [BR-DGE REST API].
Please ensure you support the [3-D Secure Payment Flow] as Google Pay transactions with authMethod PAN_ONLY must comply with SCA and network regulations. BR-DGE will submit the PAN_ONLY credentials and 3-D Secure information for improved chances of a successful payment.

We do not restrict payments to and from other countries, please refer to your PSPs documentation for their accepted authorization methods and supported card networks.

❗️
All merchants must adhere to the Google Pay APIs [Acceptable Use Policy] and accept the terms defined in the Google Pay API [Terms of Service]. For more information, see Google Pays [Brand Guidelines].

Add the Google Pay Module to Your App

After you have set up the [Comcarde JavaScript Client], you can add the google-pay module to your website source.

<script src="https://sandbox-assets.comcarde.com/web/v2/js/google-pay.min.js"></script>

<script src="https://assets.comcarde.com/web/v2/js/google-pay.min.js"></script>

Next insert a placeholder element to your page and give it a unique id so the google-pay module can populate it with a Google Pay button, for example:

<div id="google-pay-button"></div>

Finally, add Google Pay functionality to your [Comcarde JavaScript Client]:

comcarde.client.create(
  {
    authorization: client - api - key, // your client API Key
  },
  function (clientErr, clientInstance) {
    // optionally configure other plugin modules...

    // Declare empty mutable object for the comcardeGooglePayInstance
    let comcardeGooglePay = {}

    comcarde.googlePay
      .create(
        {
          client: clientInstance,
          containerId: 'google-pay-button', // <- unique identifer of your button element
        },
        function () {
          comcardeGooglePay
            .startPaymentJourney({
              /*
               * This object describes a transaction that determines a payer's ability
               * to pay. It's used to present a payment authorization dialog.
               * Please see https://developers.google.com/pay/api/web/reference/request-objects#TransactionInfo
               * for a full description
               */
              totalPriceStatus: 'FINAL',
              totalPrice: '9.99',
              countryCode: 'GB',
              currencyCode: 'GBP',
            })
            .then(function (payload) {
              /*
               * send payload.token to your server to be used as a Google Pay payment
               * instrument in a payment request.
               */
              console.log('googlePay token: ' + payload.token)
              /*
               * payload.id contains a unique identifier for the response. This will
               * be helpful to us if you need assistance or support
               */
              console.log('googlePay tokenization trace id: ' + payload.id)
            })
            .catch(function (startPaymentJourneyError) {
              console.error(startPaymentJourneyError)
            })
        }
      )
      .then(function (comcardeGooglePayInstance) {
        /*
         * Assign the Comcarde Google Pay instance to the comcardeGooglePay variable
         * for use in the payment callback
         */
        comcardeGooglePay = comcardeGooglePayInstance
      })
      .catch(function (googlePayModuleError) {
        console.error(googlePayModuleError)
      })
  }
)

Testing Google Pay

See the [Testing Google Pay] page for more information on:

Testing against a PSP sandbox.
Testing against a mock sandbox.