Creating subscriptions in Google Play Console

Create the products users will purchase. PurchaseKit uses these product IDs to match purchases to your app.

Create a subscription

  1. In Google Play Console, select your app
  2. Go to MonetizeSubscriptions
  3. Click Create subscription
  4. Enter a Product ID - this is what you'll use in PurchaseKit:
    • Use reverse domain notation: com.yourapp.pro.annual
    • Be consistent: com.yourapp.pro.monthly, com.yourapp.pro.annual
  5. Enter a name and description
  6. Click Create

Add a base plan

Each subscription needs at least one base plan:

  1. Within your subscription, click Add base plan
  2. Enter a Base plan ID (e.g., annual)
  3. Set the Billing period (weekly, monthly, yearly, etc.)
  4. Click Set price and configure pricing for each country
  5. Click Activate

Add the product to PurchaseKit

  1. In the PurchaseKit dashboard, go to your app
  2. Click Add a product
  3. Enter the Google Product ID (e.g., com.yourapp.pro.annual)
  4. Optionally, enter the Base plan ID (e.g., annual)
  5. Save the product

The product ID in PurchaseKit must exactly match the Product ID in Google Play Console.

When to use base plan IDs

Most apps create one subscription per billing period (e.g., com.yourapp.pro.annual and com.yourapp.pro.monthly). In this case, you don't need to set a base plan ID. PurchaseKit uses the first base plan automatically.

If you have a single subscription product with multiple base plans (e.g., one product ID with both monthly and annual base plans), set the base plan ID on each PurchaseKit product to target the correct plan. Without it, all products sharing the same Google product ID would show the same (first) price.

Next step

Configure Google Play Console to send webhooks to PurchaseKit.