Set up Google Pay with Zuora JavaScript SDK
Integrate Google Pay into your checkout flow using Zuora's JavaScript SDK, supporting hosted checkout and various payment gateways.
You can add a Google Pay™ button to your checkout flow by integrating with a JavaScript SDK provided by Zuora. This integration supports Google Pay's Hosted Checkout feature, simplifying the process by bypassing complex certification and domain registration. In the hosted checkout flow, Zuora's merchant ID is used. You do not need to register your own merchant ID.
Currently, this integration is supported on the following payment gateway integrations:
- Adyen Integration v2.0
- Braintree v2.0
- Checkout.com
- Stripe v2
- Worldpay 1.4
For authentication methods, both PAN_ONLY and CRYPTOGRAM_3DS are supported, ensuring compatibility across both Android devices and Google Pay compatible browsers. For Google Pay on Stripe v2, CRYPTOGRAM_3DS is only supported in sandbox environments.
Zuora is continuing to evaluate other payment gateways for Google Pay integration. If you have any requests on other gateways, please contact your Zuora account team.
This section describes how to add Google Pay to your checkout flow by integrating with the latest version of JavaScript SDK provided by Zuora. If you need guidance for the legacy version of the JavaScript SDK, see Set up Google Pay with legacy version of Zuora JavaScript SDK.
Overview
The following diagram shows how the Google Pay JavaScript SDK integration works in a checkout experience:
Overall, you need to complete the following tasks to set up Google Pay by integrating with Zuora's JavaScript SDK:
- Complete prerequisite tasks before integration.
- Implement the client-side SDK integration.
- Implement the server-side API integration.
- Perform integration testing.
This feature is in the Early Adopter phase. We are actively soliciting feedback from a small set of early adopters.
Prerequisites
- Understand the guidelines and requirements of Google Pay:
- Google Pay Web Brand Guidelines. Ensure that only approved branding by Google is used when referencing Google Pay.
- Review and adhere to Google Pay API Terms of Service and Acceptable Use Policy.
- Ensure that the requirements for the gateway are met:
- You have signed up for a merchant account for the gateway.
- For Google Pay on Stripe, contact Stripe for gated access to the Processing Google Pay Decrypted Tokens API.
- Turn on the Payment Form feature in Zuora: The JavaScript SDK integration utilizes the publishable key from the Payment Form feature for authentication. This integration supports embedding the Google Pay button within an iframe hosted by Zuora. To enable Payment Form on your tenant, see the "Before you start" section in Configure payment forms.
- Get your testing environment ready. See Supported browsers by Google Pay for more information.