# Stripe connector for Google Play Store*

Automate recurring file imports from Google Play Store to Stripe.

To set up an automated job for importing data and make sure that your Stripe products remain up-to-date, you can import files from the Google Play Store into the Stripe Data Management Platform.

## Before you begin

Before you integrate, make sure that you have:

1. An active Google Cloud and Play Console account with access to the application files.
2. Admin account access to the Stripe Dashboard.
3. Enabled the APIs for Google Cloud Storage and Google Play Android Developer.
4. A service account on Google Cloud platform. The Data Connector uses this account to access your application’s financial reports.
5. The private key of your service account that’s saved securely.
6. The service account added under **Users and permissions** in Play Console.
7. The Google Cloud Storage URI for your financial reports.

> #### Disclaimer
> 
> By using this Stripe Connector you warrant that you’ve obtained the requisite permissions, and provided the necessary notices and consents required, for you to use the Stripe Connector and to enable Stripe to provide you the Services.

## Enable the APIs

To enable the necessary APIs:

1. Sign in to the [Google Cloud Console](https://console.cloud.google.com/), then select your project for the application in the top left corner.
2. Click **API and Services** > **Enabled APIs & services** in the left pane.
3. If the list on this page contains the **Cloud Storage API** and the **Google Play Android Developer API**, skip this step and [create a service account key](https://docs.stripe.com/data/import-external-data/connectors/google-play.md#generate-keys) instead. Otherwise, click **Enable APIs and Service**.
4. Search for **Play Store**, then select **Google Play Android Developer API**.
5. Click the **Enable** button.

## Set up a service account

To create a service account:

1. Click **Credentials** under **APIs & Services** in the left pane.
2. Click **+ Create credentials** > **Service account**.
3. Enter a name and description for the service account. The Data Connector uses this account to access your application’s financial reports.
4. Add the **Storage Object Viewer** role from the **Role** dropdown, then click **Done**.

## Create service account keys

After you create the service account, Google Cloud redirects you to the Credentials page. From this page:

1. Click the service account that you created.
2. On the Keys page, click **Add key** > **Create new key**.
3. Select **JSON**, then click **Create** to download a private key on your device. Make sure that you secure this private key. If you lose it, you must generate a new one because it’s the only copy of the private key.

## Integrate the service account in Play Console

To integrate the service account on Play Console:

1. On the [Play Console page](https://play.google.com/console/), click **Users and permissions** in the left pane.
2. Click **Invite new user**.
3. Enter the email address of the service account you created.
4. Under **App permissions**, click **Add app**.
5. Select each app whose financial reports you want to import, then click **Apply**.
6. Select **View app information (read-only)**, **View financial data**, and **Manage orders and subscriptions**, then click **Apply**.
7. Click **Invite user** > **Send Invite**.

When you add an app to your reports, grant the service account the same permissions for the new app. Successful authentication doesn’t guarantee that the service account can access every app.

## Prepare the service account credentials

To prepare the service account credentials:

1. In the Google Play Store Console Dashboard, click **Copy Cloud Storage URI** to copy your Google Cloud Storage URI. The URI begins with `pubsite_prod_rev` (for example, `pubsite_prod_rev_01234567890987654321`).
2. Keep the service account credentials JSON file available for upload in the Stripe Dashboard.

## Configure the Stripe connector for Google Play Store

To configure the Stripe connector for Google Play Store using Stripe:

1. Click **+ Set up connector** > **Google Play Store** in the [Connectors tab on the Data management page](https://dashboard.stripe.com/data-management/connectors).
2. Enter a name, then click **Next**.
3. Review the permissions, then click **Next**.
4. Upload your private key file in the **Private key** section, then enter the **Google Cloud Storage Bucket ID**. If the Dashboard asks for an **App package name**, enter the package name displayed under the app name in Play Console.
5. Click **Authenticate** to establish a connection.

If the Dashboard doesn’t ask for a package name, Stripe discovers all apps in the connected reports. You don’t need to create a separate connection for each app. Apps without report data aren’t discovered. Give the service account access to each app whose subscription catalog you want Stripe to fetch.

## Maintain your Google Play Store connection

After Stripe establishes your connection, it takes up to 24 hours for the first sync to begin showing your data in the Dashboard. After that, we fetch your data once a day. To monitor the health of your connection:

1. View the status and the latest sync details of your established connections in the [Data Management Connector Dashboard](https://dashboard.stripe.com/data-management/connectors).
2. Click the connector to manage an individual connection. You can edit the name, re-authenticate a broken connection, and delete a connection.

For connections that discover apps from reports, **App catalogs** lists each discovered app package. Apps that require attention show one of the following statuses:

- **Pending catalog fetch**: Stripe discovered the app but hasn’t finished fetching its catalog.
- **No subscriptions found**: Stripe fetched the catalog but found no subscriptions.
- **Catalog fetch failed**: Stripe couldn’t fetch the catalog. Follow the displayed guidance and verify that the service account has access to the app.

Apps with successfully fetched catalogs show only their package names. An empty list means Stripe is waiting to discover apps from the connected reports. A fetched catalog doesn’t guarantee that every transaction includes subscription details or that revenue recognition is complete. When you update credentials for an existing connection, Stripe retains the saved package name.

\*Google Play is a trademark of Google LLC.