Android Reucrring Plan Setup

Follow this step-by-step guide to create and configure Android recurring subscription plan in Google Play Console for your Android application.

Setup Android Subscription Plan

1. Create the Subscription Product in Google Play Console

1. Open Google Play Console.
2. Select the required application.
3. Go to Monetize with Play → Products → Subscriptions.
4. Click Create subscription.
5. Click Create.

Subscription Details

Enter the required subscription details.

Product ID : com.gobiz.intermediate.recurring.plan
Name       : Intermediate Plan

Important: The Product ID cannot be changed or reused after the subscription has been created.

2. Add a Base Plan

After creating the subscription, open the newly created subscription.

Under Base plans and offers, click Add base plan.

Base Plan Configuration

Base Plan ID : recurring 
Type         :  Auto-renewing

Note: The Base Plan ID must follow Google Play's naming rules and cannot be changed after the plan is created.

Click Save to create the base plan.

3. Configure Price and Availability

Open the newly created base plan and configure the Price and availability section.

1. Select All regions.
2. Review the regional pricing generated by Google Play.
3. Set or verify the required regional prices.
4. Save the pricing configuration.

Example

Subscription: Intermediate Plan
Billing Period: Monthly
Price: $20.00

After saving the regional prices, Google Play displays a confirmation that the pricing configuration has been saved.

4. Activate the Base Plan

After the pricing configuration has been saved:

1. Return to the subscription.
2. Verify that the base plan is listed under Base plans and offers.
3. Confirm that the base plan is Active.
4. If the base plan is inactive, use the available activation option to activate it.

5. Identify the Google Play Subscription Details

The Android application requires both the Product ID and Base Plan ID.

Example

Product ID:    com.gobiz.intermediate.recurring.plan
Base Plan ID:  recurring

Use the actual values configured in Google Play Console.

6. Configure the Plan in GoBiz Admin Panel

1. Log in to the GoBiz Admin Panel.
2. Go to Plans.
3. Locate the corresponding plan.
4. Open the plan's Edit option.

Example

Plan Name:      Intermediate Plan
Plan Price:     $20.00
Plan Validity:  Monthly
Status:         Active

7. Configure In-App Purchase Details

Scroll to In-App Purchase Details (Mobile App).

Enter the Android subscription details.

Purchase Type : Recurring                           
Product ID    : com.gobiz.intermediate.recurring.plan 
Plan ID       : recurring-monthly

Purchase Type

Select Recurring for a recurring subscription.

Product ID

Enter the Product ID created in Google Play Console.

Plan ID

Enter the corresponding GoBiz application-side Plan ID for the subscription.

The Product ID must exactly match the Product ID configured in Google Play Console. The Plan ID should match the identifier expected by the GoBiz Android application.

8. Save the Plan Configuration

1. Verify that the Product ID matches the Product ID in Google Play Console.
2. Verify that the Plan ID is the correct identifier for the corresponding GoBiz subscription.
3. Click Save.

Video Tutorial

Android Google Play Pub/Sub Setup

how to configure Google Play Real-Time Developer Notifications (RTDN) for Android subscriptions using Google Cloud Pub/Sub

1. Google Cloud Project

Open the required project in Google Cloud Console.

Example project

Project name: GoBiz Demo
Project ID:   gobiz-demo

All Pub/Sub resources used for this integration should be created inside the Google Cloud project configured for the Android application.

2. Create a Google Cloud Service Account

Open:

Google Cloud Console → IAM & Admin → Service Accounts

Click Create service account.

Service account configuration

Service account name : play-api                                     
Service account ID   : play-api                                    
Description          : To receive Google Play subscription messages.
Role                 : Pub/Sub Admin

The resulting service-account email will look similar to:

[email protected]

Click Create and continue and complete the service-account creation.

3. Create the Service Account JSON Key

After creating the service account:

1. Open Google Cloud Console → IAM & Admin → Service Accounts.
2. Locate the play-api service account.
3. Open the Actions menu.
4. Select Manage keys.
5. Click Add key.
6. Select Create new key.
7. Select JSON.
8. Click Create.

Google Cloud will download the JSON credentials file to your computer.

Rename the downloaded file to:

service-accounts.json

This file is required by the server-side application to authenticate with Google APIs.

4. Create the Pub/Sub Topic

Open:

Google Cloud Console → Pub/Sub → Topics

Click Create topic.

Topic configuration

Set the Topic ID to:

play-notifications

Enable:

Add a default subscription

After creation, the topic resource will look similar to:

projects/gobiz-demo/topics/play-notifications

Verify that the topic appears under:

Pub/Sub → Topics

Configure the topic in Google Play Console

Copy the complete topic name:

projects/gobiz-demo/topics/play-notifications

Then open:

Google Play Console → Monetize with Play → Monetization setup

Paste the complete topic name into the Topic name field.

Save the configuration.

Important: Use the complete Pub/Sub resource name, not only play-notifications.

5. Grant Pub/Sub Publisher Permission

Google Play needs permission to publish RTDN messages to the Pub/Sub topic.

Open:

Google Cloud Console → Pub/Sub → Topics

Select:

play-notifications

Open the topic's Permissions / Access configuration and select Grant access.

Principal

Add:

[email protected]

Role

Assign:

Pub/Sub Publisher

Save the permission.

Verify the permission

Open the topic's permissions panel and confirm that the following entry exists:

Role: Pub/Sub Publisher

Principal:[email protected]

Google Cloud may indicate that the permission change can take a few minutes to become active.

Important: Do not use the play-api service account as the publisher principal. Google Play publishes RTDN messages using [email protected].

6. Configure Google Play Console Permissions

Open:

Google Play Console → Users and permissions

Click Invite new users.

Enter the Google Cloud service-account email created in Step 2.

Example

[email protected]

Important: Use the play-api service account here.

6.1 Grant App Permission

Under App permissions:

1. Select your application.
2. Click Apply.
3. Grant:

- View app information (read-only)
- View financial data
- Manage orders and subscriptions

Do not grant Admin (all permissions) unless the application integration specifically requires it.

These permissions allow the server-side integration to access the Google Play purchase and subscription information required for subscription management.

Click Apply / Invite user to save the permissions.

Verify the service-account permissions

The play-api service account should have:

App permission: View app information (read-only)

Financial permissions: View financial data 

Manage orders and subscriptions

7. Configure Google Play Real-Time Developer Notifications

Open the Android application in Google Play Console.

Navigate to:

Monetize with Play → Monetization setup

Find:

Google Play Billing

Locate:

Real-time developer notifications

Enable:

Enable real-time notifications

7.1 Enter the Pub/Sub Topic

In Topic name, enter the complete Pub/Sub topic resource:

projects/gobiz-demo/topics/play-notifications

The complete resource name is required.

Google Play will publish subscription and purchase notification messages to this Pub/Sub topic.

7.2 Select Notification Content

Select:

Subscriptions and voided purchases only

Save the Google Play Billing configuration.

Verify the RTDN configuration

Before continuing, confirm:

RTDN: Enabled

Topic: projects/gobiz-demo/topics/play-notifications

Notification content: Subscriptions and voided purchases only

8. Create the Pub/Sub Subscription

Open:

Google Cloud Console → Pub/Sub → Subscriptions

If Add a default subscription was enabled while creating the topic, a subscription may already have been created automatically.

The expected subscription name in this setup is:

play-notifications-sub

If it does not already exist, create a subscription for the topic.

Subscription configuration

Subscription ID: play-notifications-sub

The resulting subscription resource will look similar to:

projects/gobiz-demo/subscriptions/play-notifications-sub

The subscription must be attached to:

projects/gobiz-demo/topics/play-notifications

Verify the subscription

Confirm that:

Subscription: play-notifications-sub

Topic: play-notifications

The subscription is responsible for receiving messages published by Google Play to the Pub/Sub topic.

9. Configure the Subscription Delivery Type

Open:

Google Cloud Console → Pub/Sub → Subscriptions → play-notifications-sub

Click Edit.

Change the delivery type to:

Push

The push subscription sends Pub/Sub messages directly to the application's webhook endpoint.

9.1 Get the Android Webhook URL

Open the GoBiz Admin Panel.

Navigate to:

Plugins → Mobile App API

Locate:

Webhook URL (Android)

Copy the Android webhook URL.

9.2 Configure the Push Endpoint

Return to:

Google Cloud Console → Pub/Sub → Subscriptions → play-notifications-sub → Edit

Under Push configuration, set:

Delivery type: Push

Endpoint URL: <Android Webhook URL copied from GoBiz Admin Panel>

9.3 Enable Authentication

select Enable.

For Service account, select the service account created in Step 2:

[email protected]

For Audience (Optional), enter the same webhook endpoint URL.

Push configuration should look similar to:

Delivery type: Push

Endpoint URL: <Android Webhook URL>

Authentication: Enabled

Service account: [email protected]

Audience: <Android Webhook URL>

Save the subscription configuration.

9.4 Test the Google Play Notification

After saving the Pub/Sub push configuration:

1. Open Google Play Console.
2. Navigate to Monetize with Play → Monetization setup.
3. Open the Google Play Billing configuration.
4. Locate the configured Topic name.
5. Click Send test notification.

Google Play will send a test RTDN message to the configured Pub/Sub topic.

The Pub/Sub subscription should then deliver the message to the configured Android webhook endpoint.

If the test notification reaches the application successfully, the Pub/Sub RTDN connection is configured correctly.

10. Server Configuration — Upload service-accounts.json

The Google Cloud service-account JSON file created in Step 3 must be uploaded to the application server.

Open the server's File Manager.

Navigate to:

storage
└── app
    └── google

If the google directory already exists, open it.

Upload:

service-accounts.json

The final file path must be:

storage/app/google/service-accounts.json

Video Tutorial