Skip to main content

Merchant Onboarding Guide​

This section provides a step-by-step walkthrough of the merchant registration and onboarding process with Google Pay. Merchants using the Server-to-Server integration must complete these steps independently before processing live transactions.

info

The steps and interfaces described in this section are based on the Google Pay & Wallet Console as of the time of writing. Google may update their platform, click-flow, or requirements at any time. We recommend always referring to the official Google Pay developer documentation and Google Pay Business Console for the most current information.

1. Create a Google Account​

A Google Account is required to access the Google Pay & Wallet Console. Create one at https://accounts.google.com/.

  • It is possible to use an existing personal Google account, but it is recommended to create a separate account for your business.
  • When creating the account, select "For work or my business" to set up a business account.
  • You can choose to use an existing email address or create a new Gmail address.

Sign in with Google Account — Create a business account.

Sign in Google Account

2. Register a Business in the Google Pay & Wallet Console​

A business must be created in the Google Pay & Wallet Console.

  • Sign in with the Google account created in Step 1.
  • Fill in the required business information:
    • Public business name — The name displayed to customers.
    • Type of business — Select "Merchant".
    • Business location — The country where the business is registered. This cannot be changed later.
  • Accept Google Pay and Wallet Console's Additional Terms of Service.

Sign in Google Account

  • After registration, the business Dashboard is displayed.

Sign in Google Account

tip

Make sure you are signed in with the correct Google account when accessing the Console. You can verify and switch accounts in the top-left corner.

The Dashboard shows the following configuration areas:

  • Business Profile — Business identity and information (must be completed before going live).
  • Google Pay API — API integration settings (domains, integration type, buyflow screenshots).

The Google Pay Merchant ID is a unique identifier for your business. It is displayed at the top of the Dashboard next to your business name and can also be found by clicking on your business name.

Sign in Google Account

3. Complete the Business Profile​

The Business Profile is accessed from the Dashboard by clicking the "Business Profile" tile. It has two sections:

Business Identity​

Set up a payments profile to identify your business across Google:

Sign in Google Account

Sign in Google Account

If a payments profile already exists in your Google account, you can reuse it. Otherwise, create a new one.

Business Information​

Edit the business information fields:

Sign in Google Account

Once the payments profile is created and the business information is sufficiently complete, the profile will be reviewed and approved by Google. The approval status is displayed at the top of the Business Profile page.

4. Integrate the Google Pay API​

The Google Pay API can only be integrated once the merchant has a website or app that uses Google Pay for payments. The buyflow (purchase flow) must be developed before completing this step.

Required buyflow screenshots​

Google requires screenshots of the following stages of your purchase flow:

  1. Item selection — When a user is browsing an item or service.
  2. Pre-purchase screen — When a user is ultimately ready to make a purchase.
  3. Payment method screen — When a user selects Google Pay as their payment method.
  4. Google Pay API payment screen — When a user is shown the payment info they have saved to Google Pay.
  5. Post-purchase screen — When a user has made a successful purchase.

Steps to integrate​

  1. In the Google Pay & Wallet Console Dashboard, click "Google Pay API".
  2. Select "Web integration" to add a website.

Sign in Google Account

  1. On the "Web integration" page, provide:
    • Website URL — Enter the full domain (HTTPS required). This must be the complete subdomain of the website, not just the top-level domain (no redirects). If the shop is available on multiple domains (e.g. multiple languages), repeat this step for each domain.
    • Integration type — Select "Gateway". The list of supported payment providers under "our supported Payment Service Providers (PSPs)" contains our platform.
    • Buyflow screenshots — Upload screenshots for each of the 5 required stages listed above.

Sign in Google Account

  1. Save your progress at any point — intermediate states are preserved.
  2. When all information is complete, the page displays "Integration is ready to submit". Click "Submit for approval" to request Google's approval.

Sign in Google Account

note

The exact click-flow and details of the integration process may change over time as Google updates their console. The steps above reflect the process as of the time of writing.

Once approved, you can process live Google Pay transactions. Note that approvals may take several days.

5. Integrate the Google Pay API on Your Frontend​

To display the Google Pay button and collect payment data, the merchant must integrate the Google Pay API on their frontend. Follow the official documentation for your platform:

Include the Google Pay API library​

For web integration, include the Google Pay API JavaScript library in your page:

<script src="https://pay.google.com/gp/p/js/pay.js"></script>

Key configuration objects​

The following objects are required when configuring the Google Pay API on your frontend:

merchantInfo​

Identifies the merchant to Google Pay. The merchantId is the ID obtained from the Google Pay Business Console during the sign-up process.

const merchantInfo = {
  merchantId: "YOUR_GOOGLE_MERCHANT_ID",
  merchantName: "Your Shop Name"
};
allowedPaymentMethods​

Defines which card networks, authorization methods, and tokenization configuration are used. The gateway is provided by our platform during onboarding, and the gatewayMerchantId value represents the merchant-specific identifier in your system.

const allowedPaymentMethods = [{
  type: "CARD",
  parameters: {
    allowedAuthMethods: ["PAN_ONLY", "CRYPTOGRAM_3DS"],
    allowedCardNetworks: ["VISA", "MASTERCARD"]
  },
  tokenizationSpecification: {
    type: "PAYMENT_GATEWAY",
    parameters: {
      gateway: "provided_by_OneAPI",
      gatewayMerchantId: "merchant_id_in_your_system"
    }
  }
}];

Handling the Google Pay token​

When the customer successfully authenticates, the Google Pay API returns a paymentData object containing the encrypted token. This token must be sent to your backend and then forwarded to our Payment API (see Server-to-Server — Create a payment with wallet cryptogram).

tip

For the complete frontend integration guide — including button rendering, paymentData handling, and brand guidelines — refer to:

Last updated on