Integrate Google Pay

To start processing payments via Google Pay, you first need to register your business profile with Google. After completing the required steps, Google provides you with a unique Google Pay merchant ID, which is essential for production. After that, you can add the Google Pay button to your checkout page and start requesting your customer’s encrypted payment information.

To use Google Pay on the Guide
Enable Google Pay button to give your customers more payment options. Payment Form or via Guide
Accept and manage credit card payments from your customers. Host-to-host integration, you need to register as a business and verify your domain in Google Pay & Wallet console Reference .

Set up Google Pay

Google takes time to review applications and contacts if they need more details. Once they check and verify the provided details, your integration becomes active.

When you submit a payment data request to the Google API, be sure to include the following parameters:

1
2

'gateway': 'solid'
'gatewayMerchantId': '\<Replace with your public api key\>'

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

{
    apiVersion: 2,
    apiVersionMinor: 0,
    allowedPaymentMethods: [{
        type: 'CARD',
        parameters: {
            allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
            allowedCardNetworks: ['AMEX', 'DISCOVER', 'MASTERCARD', 'VISA']
        },
        tokenizationSpecification: {
            type: 'PAYMENT_GATEWAY',
            parameters: {
                'gateway': 'solid',
                'gatewayMerchantId': ''
            }
        }
    }]
}

If you are using Solidgate Payment Form, see the Google Pay button guide for button display, positioning, styling, and hiding options. For host-to-host token decryption, see Google Pay H2H.

After integrating Google Pay into your payment system, the next step is to test the integration to confirm it works correctly.

Handle integration errors

Errors may occur when sending requests or processing responses for Google Pay payments. If an error occurs, check the following:

• Verify that all parameters are added when connecting Google Pay as a payment method.
  • Include all required parameters from the Solidgate Google Pay API
  • Ensure that paymentIntent contains all required parameters
• For Guide
  Accept and manage credit card payments from your customers. Host-to-host integration, confirm that gatewayMerchantId parameter has the relevant public API key.
• In case of the Guide
  Processing error. Verify the merchant’s settings and configurations. 5.04 error, verify your Guide
  Learn to authenticate API requests and fix validation errors effectively. API keys by navigating to Hub > Developers > Channels.
• For Android WebView integration
  • Ensure the WebView version is 137 or later
  • Confirm that Google Play Services version is 25.18.30 or later
  • Verify that the payment request feature is enabled in WebView settings
  • Confirm that JavaScript is enabled
  • Check that required <queries> tags are added to your AndroidManifest.xml for Chromium payment actions

If the OR_BIBED_11 error occurs in WebView, ensure your Android app has been approved for production access in the Google Pay & Wallet console Reference . This error typically indicates that you are using the Production environment without production access approval. For implementation details and troubleshooting, refer to the Google Reference guide.

You can test the Google Pay payments when setting up the integration.

If the outlined recommendations do not resolve the issue, contact us for further assistance. When contacting, share the details of the issue and the steps you have taken to resolve it.