[
{
"title":"Testing",
"link":"https://docs.solidgate.com/payments/testing/",
"text":"Simulate payments to test your integration before launching in production.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-customizable.svg"
}
,
{
"title":"Create your payment form",
"link":"https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form/",
"text":"Understand how to integrate the payment form into your product.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-payments.svg"
}
,
{
"title":"Subscriptions",
"link":"https://docs.solidgate.com/subscriptions/",
"text":"Create and maintain a stable and healthy business subscription model.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-global.svg"
}
]
Enable Google Pay button to give your customers more payment options
Add Google Pay as a payment option to your Solidgate Payment Form to provide customers with a fast and secure way to pay with cards saved in their Google account. Once integrated, the Google Pay button appears on your form, allowing customers to complete purchases seamlessly.
Solidgate Payment Form meets Google’s integration standards for Google Pay, ensuring a smooth checkout experience across Android devices and web browsers. Follow this guide to set up Google Pay, making it easier for customers to use their preferred payment methods.
Display button
Start with the following required steps to add Google Pay to the Solidgate Payment Form:
Domain verification Verify your domain on the Google site. For this you need to have a Google developer account.
Merchant ID Obtain the merchant ID parameter from the Google console, which enables Google Pay transactions on your site.
Upon completion of these steps, you can proceed with adding Google Pay to the Solidgate Payment Form.
To display the Google Pay button on the Solidgate Payment Form, you must add the GooglePay properties to the paymentIntent object. Google Pay can be accessed and used on the platforms listed in the Google guide.
GooglePay properties
Expand all
Description
Merchant ID parameter you receive on Google’s side.
Required for displaying the Google Pay button.
Example
10911390523550288022
Description
Merchant name, which can be displayed to the customers when paying by Google.
It would be better to pass this parameter so that Google does not substitute it on its own.
Example
Solidgate
Subscribe to the Google Pay mounted event to check when the button is mounted and rendered. When the event is emitted for the googlebtn entity, this means the Google Pay button is fully displayed.
You can track payment form activity by subscribing to its
Guide
Using the payment form, you can build your user actions tracking by the events that the Solidgate payment form returns.
events
.
If errors occur during a Google Pay payment attempt after the integration setup and button configuration, please review the essential steps to ensure the integration is configured as intended and test it.
Customization
In addition to displaying the button on the payment form, you can also control the button position, color, and size. Use the googlePayButtonParams object for changes as you would for all other customization in the Solidgate
Guide
Create a seamless experience for customers by styling your payment form.
Payment Form
.
Customization properties
Expand all
Description
Displays the Google Pay button.
Example
false
Default
true
Description
Identifier of container to place the Google Pay button.
By default, if not set, button will be displayed above the form.
PAN_ONLY: This authentication method is associated with payment cards stored on file with the user’s Google Account. Returned payment data includes personal account number (PAN) with the expiration month and the expiration year.
CRYPTOGRAM_3DS: This authentication method is associated with cards stored as Android device tokens. Returned payment data includes a 3-D Secure (3DS) cryptogram generated on the device.
The capability to transmit only PAN_ONLY or CRYPTOGRAM_3DS is also available, and such transmission will work for both one-time payments and subscriptions.
<template><Payment:merchant-data="merchantData":google-pay-button-params="google"width="100%"/></template><scriptlang="ts"setup>import{defineAsyncComponent}from'vue'import{InitConfig}from'@solidgate/vue-sdk'constPayment=defineAsyncComponent(()=>import('@solidgate/vue-sdk'))constmerchantData:InitConfig['merchantData']={merchant:'<<--YOUR MERCHANT ID-->>',signature:'<<--YOUR SIGNATURE OF THE REQUEST-->>',paymentIntent:'<<--YOUR PAYMENT INTENT-->>'}constgoogle:Omit<InitConfig['googlePayButtonParams'],'containerId'>={color:'white',type:'plain',allowedAuthMethods:['PAN_ONLY','CRYPTOGRAM_3DS']}</script>
import{Component}from'@angular/core';import{FormType,InitConfig}from"@solidgate/angular-sdk";@Component({selector:'app-root',template:`
<ngx-solid-payment
[googlePayButtonParams]="google"
[merchantData]="merchantData"
></ngx-solid-payment>
`})exportclassAppComponent{merchantData: InitConfig['merchantData']={merchant:'<<--YOUR MERCHANT ID-->>',signature:'<<--YOUR SIGNATURE OF THE REQUEST-->>',paymentIntent:'<<--YOUR PAYMENT INTENT-->>'}google: Omit<InitConfig['googlePayButtonParams'],'containerId'>={color:'white',type:'plain',allowedAuthMethods:['PAN_ONLY','CRYPTOGRAM_3DS']}}
Button position
To position the Google Pay button as needed, create and specify the div. Then, pass the value of the created container to the containerId parameter in the googlePayButtonParams object.
<template><Payment:merchant-data="merchantData":google-pay-container-ref="googleButton"/><divref="googleButton"/></template><scriptlang="ts"setup>import{defineAsyncComponent,ref}from'vue'import{InitConfig}from'@solidgate/vue-sdk'constPayment=defineAsyncComponent(()=>import('@solidgate/vue-sdk'))constgoogleButton=ref<HTMLDivElement>()constmerchantData:InitConfig['merchantData']={merchant:'<<--YOUR MERCHANT ID-->>',signature:'<<--YOUR SIGNATURE OF THE REQUEST-->>',paymentIntent:'<<--YOUR PAYMENT INTENT-->>'}</script>
import{Component}from'@angular/core';import{FormType,InitConfig}from"@solidgate/angular-sdk";@Component({selector:'app-root',template:`
<ngx-solid-payment
[merchantData]="merchantData"
[googlePayContainer]="googlePay"
></ngx-solid-payment>
<div class="google-pay" #googlePay></div>
`})exportclassAppComponent{merchantData: InitConfig['merchantData']={merchant:'<<--YOUR MERCHANT ID-->>',signature:'<<--YOUR SIGNATURE OF THE REQUEST-->>',paymentIntent:'<<--YOUR PAYMENT INTENT-->>'}}
In this example, the div with the id yourCustomContainerId is created in the HTML, and its id value is passed to the containerId parameter in the googlePayButtonParams object.
This specifies that the Google Pay button should be rendered inside the specified container.
If you do not specify the containerId, Solidgate displays it above all fields of the Solidgate Payment Form by default.
Please note that if you specify a container that does not exist, the Google Pay button will not be displayed. In this case, Solidgate will return the error to the console.
Container with id =‘specified-container’
does not exist.
Button styling
Some options on the Payment Form allow customization of the Google Pay button to better match the style of your site.
Solidgate allows changing two parameters of the button in the googlePayButtonParams object:
default
- may change the color over time (light/night mode).
black
- a black button suitable for use on a white or light background.
white
- a white button suitable for use on a colorful background.
Supported types:
buy
- a 'Buy with Google Pay' button (default).
plain
- button without additional text.
checkout
order
pay
subscribe
Not supported types:
donate
book
Button hiding
To hide the button for the customer, pass
false
to the enabled parameter. You do not need to specify
true
to display the button on the form as it is a default value. When you pass the
false
value, the form with the passed parameters of containerId, color, and type is collected but not displayed on the Solidgate
Guide
Create a seamless experience for customers by styling your payment form.
Payment Form
.