Google Play Setup Guide
Connect your Google Play app to B4X Purchase Manager for Android purchase validation. All configuration is done in the Google Play Console — no files to download or secrets to manage.
Open Users and Permissions
In Google Play Console, go to Setup → Users and Permissions in the left sidebar.
Open Users and PermissionsInvite the service account
Click Invite new users and enter our service account email:
b4x-purchase-validator@b4x-purchase-validator.iam.gserviceaccount.comThis is a Google Cloud service account — not a person. It can only access what you explicitly grant it.
Set Account permissions
On the permissions page, scroll to the Financial data section and only check:
✅ View financial data, orders and cancellation survey responses
This is the only permission needed — it grants read-only access to the purchases API. With this permission, we cannot modify, refund, or cancel anything — we can only verify purchase status.
Select your apps
After saving, click Manage next to the service account, then go to the App permissions tab.
Click Add app and select each app you want to validate purchases for. Apps automatically inherit the account permissions you set in Step 3.
⚠️ This step is easy to miss
Even after inviting the service account, each app must be explicitly added under App permissions. Without this, purchase validation will fail with "Permission denied".
Verify the connection
Go to your app's detail page in the B4X Purchase Manager dashboard. The Google Play Setup card shows a live connection status:
• Status: Connected — the service account has access and purchase validation will work
• Status: Pending — the service account is invited but this specific app hasn't been added under App permissions yet. Go back to Step 4 and add the app
• Status: Not Connected — the service account hasn't been invited yet. Start from Step 1
Use the Recheck button after making changes in Google Play Console. Once connected, the status is cached so the page loads instantly.
Propagation times
After the initial invite, permission changes typically take effect within a few minutes but may take up to 24 hours to fully propagate through Google's systems. If the connection status still shows "Not Connected" right after setup, wait a bit and click Recheck.
Adding new apps later should take effect immediately — no waiting required.
Troubleshooting
"Permission denied" from Google Play API
The service account hasn't been invited, or the Financial data permission wasn't granted, or the specific app wasn't added under App permissions.
"Purchase not found or invalid token"
The purchase token is invalid, expired, or the package name / product ID doesn't match your Google Play listing.
"validator_not_configured"
This is a server-side issue — contact support.