Google Play Store

Requirements:

• Google Play Developer Account
• App setup on Google Play Console
• Google Cloud Project with Google Play Android Developer API enabled and linked to your Play Console account.

Connecting the Platform

Go to Integrations > Google Play Store > Connect Platform (if not already connected). This will open a dialog with a form to fill out.

Bundle ID

This is your application’s bundle id. It’s usually in com.company.example format and you can find it on Google Play Console > Select Your App.

On the dashboard you should see the bundle id right below the app name. It should be in the format com.company.example. Copy and paste it in the respective field in Crosspay form.

Google Cloud Project ID, Billing Topic Name and Service Account JSON

To allow Crosspay to retrieve purchase information, transaction history and validating purchases for a given user, you need to create a service account in Google Cloud, and link it to your Play Console account.

1. Go to Google Cloud Console and create a new project or select an existing one.
2. Then in the dashboard, you’ll see the Project ID right below the project name. Copy and paste it in the respective field in Crosspay form.
3. Enable the “Google Play Android Developer API” for your project.
4. Go to “IAM & Admin” > “Service Accounts” and create a new service account. Give it a name like “Crosspay Access”.
5. For permissions, give it the Pub/Sub Admin role.
6. After creating the service account, click on it to open its details, then go to the “Keys” tab and create a new key in JSON format. This will download a JSON file to your computer. Make sure to store it securely, as it contains sensitive information.
7. On the Details tab of the service account, you’ll also find the Email field. Copy the email address.
8. Go to your Google Play Console > Users and permissions > Invite new user. Paste the email address of the service account you just created, and give it following permissions for your specific app:
   • View app information (read-only)
   • View app quality information (read-only)
   • View financial data
   • Manage orders and subscriptions

So we’ve Service Account JSON and the Project ID.

Creating Billing Topic

1. Go to, Google Cloud Console > Pub/Sub > Topics > Create Topic
2. Give it a name like crosspay-billing-topic and create it.
3. After creating the topic, click on it to open its details, then copy the Topic name
4. In Google Play Console, select your app > go to “Monetize with Play” > “Monetization setup” > “Google Play Billing” > “Real-time developer notifications”
5. Enable the real-time developer notifications and paste the topic name you just copied in the “Cloud Pub/Sub topic” field.
6. Select Subscriptions, voided purchases, and all one-time products for Notification Content and save it.

Finally, we’ve the Topic name.

Now enter the Project ID, Topic name and upload the Service Account JSON file in the respective fields in Crosspay form and save it.

Configuring Webhooks

To allow Crosspay to receive real-time updates about purchases, subscription renewals, cancellations and other events, you need to set up subscriptions in Google Cloud Pub/Sub Console. These are known as Real-time developer notifications.

1. Go to Google Cloud Console > Pub/Sub > Click on the topic you created for billing notifications > Click on “Create Subscription”
2. Give the subscription a name like crosspay-billing-subscription
3. For the “Delivery type”, select “Push”
4. In the “Push endpoint” field, enter the Realtime Notification URL from the Crosspay Google Play Store form.
5. Leave the other settings as default and create the subscription.

Now Google Cloud Pub/Sub will start sending real-time updates about purchases, subscription renewals, cancellations and other events to Crosspay. This will allow Crosspay to keep track of the state of your users’ purchases and subscriptions, and provide you with accurate and up-to-date information in your dashboard and through our API.