Google Pay

About Google Pay

Our Payments API allows your mobile app and online store to accept payments using Google Pay.

The card networks currently supported by our Google Pay solution are VISA, Mastercard, American Express, Discover, and JCB.

Getting started

If this is your first time implementing our APIs we recommend reviewing our Reference guide , to get familiar with Worldline's Payment APIs.

You can find more about Worldline and Google Pay on Github .

Requirements

Hosted Checkout

If you are using BIC's Hosted Checkout service, there is no registration required with Google. In this case all integration with the Google Pay API will be managed by Worldline.

1. Enable Google Pay

To turn on Google Pay for your account, log into the Member Area . Under configuration, click on checkout. From the checkout screen you can include the Google Pay Button. By default, this field will be set to "No". If changed to "Yes", a Google Pay button will appear on your Hosted Checkout screen.

2. Google Pay button on Hosted Checkout

A Google Pay button will be added at the top of the Hosted Checkout screen if the option was enabled in step 1. To use Google Pay, click the GPay button.

The Google Pay sheet will open and request the user to log in to Google using their credentials. On the Google Pay sheet, select your pre-stored card saved in the Google account. To complete the purchase, select Continue.

These are the steps needed to integrate with Worldline’s APIs:

1. Registration of Merchants with Google

Merchants will need to register with Google prior to integrating with Google Pay APIs using Worldline's Gateway Registration ID. This use case covers Merchants using Worldline as their gateway processor. Worldline will encrypt and decrypt the payloads on behalf of merchants. Details of the parameters required to integrate with Google's API have been specified below in the API Requests section.

Requirements

• Android applications must first be distributed through the Google Play store before they can be integrated with the Google Pay API.

• Android devices used for testing must have Google Play services version 18.0.0 or higher installed.

• A Google Account is required to request production access to the Google Pay API. The merchant will be asked some basic information about their business and are required to agree to the Terms of Service and Privacy Policy.

For more info on the registration process for merchants, visit:

Google Pay for Payments > Android

Google Pay for Payments > Web

2. API parameters for Worldline processors

Merchants who choose to integrate with Google’s API and use Worldline as their gateway processor will need to pass the parameters mentioned below to Google’s API.

Register with Google

Merchants will need to register with Google and integrate with Google Pay APIs using Worldline's Gateway Registration ID. This use case covers Merchants using Worldline as their gateway processor. Worldline will encrypt and decrypt the payloads on behalf of Merchants. Details of parameters required to integrate with Google API have been specified below.

Pass the correct parameters to the API

Merchants who choose to integrate with Google’s API and use Worldline as their gateway processor will need to pass the parameters below to Google’s API.

Google’s integration tutorial

API requests

After you've received the Payment Data object, you'll need to extract the Google Pay transaction payload from it like so:

transactionPayload = paymentData.paymentMethodData.tokenizationData.token;

curl https://api.na.bambora.com/v1/payments \
    -H "Authorization: Passcode XXX1XXx11Xxx1xX1XxxxXxXXXXx1XXX1XxX1XXXxXXXxXxxxX11XXXxX1" \
    -H "Content-Type: application/json" \
    -d '{
          "amount": 1.00,
          "payment_method": "google_pay",
          "customer_ip": "123.123.123.123",
          "term_url": "https://www.beanstream.com/debug.asp",
          "google_pay": {
            "name": "name",
            "3d_secure": {
              "browser": {
                "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3",
                "java_enabled": "false",
                "language": "en-US",
                "color_depth": "24",
                "screen_height": 1080,
                "screen_width": 1920,
                "time_zone": -120,
                "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.90 Safari/537.36",
                "Javascript_enabled": true
              },
              "enabled": true,
              "version": 2,
              "auth_required": false
            },
            "transaction_payload": "<your_google_pay_transaction_payload>",
            "complete": true
          }
        }'

Additional info

For more information about testing with Google Pay:

Test Card Suite

Sample Tokens

*TD Support Only

If you are a TD customer and interested in Google Pay, please contact us at support@onlinemart.ca .