How to Connect RevenueStack to Google Play

Before you start

You need access to the Google Play Console developer account and a Google Cloud project. The service account must be created in Google Cloud, then invited and granted permissions in Google Play Console.

• Use a dedicated service account for RevenueStack rather than a personal user account.
• Keep the JSON key server-side and treat it like a password.
• The app package name is the application ID used by Google Play, such as com.example.app.

1. Google Play Package Name

The package name uniquely identifies the Android app in Google Play. It is also called the application ID or package ID.

1. Open Google Play Console and select the app.
2. Open the app dashboard or App integrity / app information area where the application identifier is shown.
3. Copy the complete package name exactly, including lowercase letters, periods, and any digits.
4. Confirm it matches the app whose subscriptions and prices RevenueStack should manage.

com.example.revenuestackdemo

2. Google Cloud Service Account JSON

RevenueStack uses a Google Cloud service account for server-to-server access. You create the identity and JSON key in Google Cloud, then grant that identity access in Google Play Console.

1. In Google Cloud Console, create or select the project you will use for this integration.
2. Open APIs & Services → Library, find Google Play Android Developer API, and select Enable.
3. Open IAM & Admin → Service Accounts and select Create service account. Give it a clear name such as revenuestack-play, then finish creation.
4. Open the new service account, choose Keys → Add key → Create new key, select JSON, and download the file. Keep the file private.
5. Copy the service account email address from the service-account details page. It looks like an email address ending in iam.gserviceaccount.com.
6. In Google Play Console, open Users and permissions and select Invite new users. Enter the service account email address.
7. Grant only the permissions required by the RevenueStack workflow. For subscription and billing data, Google’s getting-started guide lists View financial data, orders, and cancellation survey responses and Manage orders and subscriptions. Review the current Play Console permission descriptions before saving.
8. Accept the invitation if Google Play presents an invitation step, then verify the service account appears under Users and permissions.
9. In the separate RevenueStack application, choose Google Play, paste the package name, and paste the complete JSON file contents into the Service Account JSON field.

{
  "type": "service_account",
  "project_id": "example-project",
  "private_key_id": "example-only",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "revenuestack-play@example-project.iam.gserviceaccount.com"
}

Connect Google Play to RevenueStack

After Google Play has authorized the service account, use the two values in the authenticated RevenueStack application.

1. Paste the exact package name into Google Play Package Name.
2. Paste the full downloaded JSON object into Google Cloud Service Account JSON.
3. Save or test the connection.
4. Start with a read-only catalog import and confirm the returned app is the intended package before preparing pricing changes.