This page gives instructions for setting up Google Pay™ using our Payment Gateway API. This option lets a customer use any payment method stored in their Google account. When selected, Google returns a payment token that you can use in lieu of card details, providing your customers another safe and easy option for payment.

Using Google Pay™ through our API provides the following benefits:

• Versatile - Supported on all major web browsers. (Qualpay does not currently support Android integrations.)
• Flexible - The Google Pay™ token can be used in Authorize, Sale, Credit, and Tokenize transactions.
• Secure - Qualpay is a PCI DSS certified Level 1 compliant Service Provider and forces HTTPS on all inbound connections.

Prerequisites

Before integrating Google Pay™ with Payment Gateway API, ensure you have performed these steps:

1. Follow the instructions in the Qualpay Get Started guide to create a sandbox account, copy your Qualpay merchant ID (MID), and copy your sandbox API security key.
2. Use the Qualpay Authentication guide to format the credentials and generate your API token.
3. Follow the Qualpay API: Quick Start guide to set up a basic sale transaction.
4. Review the Google Pay™ for Payments web documentation.
5. Enroll in Google Pay™:
   • Contact Qualpay Support to enable Google Pay™ for your Qualpay account.
   • By using the Google Pay™ API, you accept the Google Pay™ API Terms of Service.

Once Qualpay Support has enabled Google Pay™, follow the instructions in the next section to integrate it.

Integrate

Perform these steps to integrate Google Pay™ with our Payment Gateway API:

1. Follow the steps in the Google Pay™ for Payments Tutorial, making modifications to the steps as described below:

   • Modification to Step 2: Request a payment token for your payment provider: Replace example with qualpay. Replace exampleGatewayMerchantId with your Qualpay Merchant ID (MID). See the sample code below:

     JSON

     const tokenizationSpecification = {
       type: 'PAYMENT_GATEWAY',
       parameters: {
         gateway: 'qualpay',
         gatewayMerchantId: 'Your Qualpay MID'
       }
     };

   • Modification to Step 3: Define supported payment card networks: Only include the card types enabled for your Qualpay account. See the sample code below:

     JSON

     const allowedCardNetworks = ["AMEX", "DISCOVER", "JCB","MASTERCARD", "VISA"];
     const allowedCardAuthMethods = ["PAN_ONLY"];

     If you are unsure which cards types are enabled for your account, perform these tasks to find enabled card types:

     • Follow the steps in Create a Sandbox Account to log in to the Qualpay merchant portal.
     • Select 'Administration' from the left-hand menu.
     • Under 'Account Configuration,' select 'Merchant Details.'

2. Optionally, add a request object for a billing address. When you do so, Google will return the customer's billing address in the response object, and you can use it in your Qualpay API request or elsewhere. Find billing address parameters on the Google Pay™ reference site for more information, and see the sample code below:

   JSON

   {
     "format": "MIN"
   }

3. Complete the request. Google will respond with a payment token.

4. Save the payment token and use it in the payload_google_pay field of your Qualpay Payment Gateway API request.

5. Ensure you have completed the Google Pay for Payments integration checklist and have followed its brand guidelines before going live.

Test and Go Live

Perform these tasks to test Google Pay™ transactions via API:

• Get Google Pay™ test cards from the Google Pay for Payments test card suite.
• See our Test and Go Live guide to test your API integration and to start transacting with an active production account.