Creating subscriptions in App Store Connect

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

Create a subscription group

Subscription groups let users upgrade or downgrade between plans without being charged twice.

  1. In App Store Connect, go to your app
  2. Select Subscriptions in the sidebar
  3. Click the + button next to Subscription Groups
  4. Enter a reference name (e.g., "Pro Plans")

Creating a new subscription group
Creating a new subscription group

Add a subscription

  1. Within your subscription group, click Create next to Subscriptions
  2. Enter a Reference Name (internal only, e.g., "Pro Annual")
  3. 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

Creating a new subscription with product ID
Creating a new subscription with product ID

  1. Click Create
  2. Configure subscription details:
    • Subscription Duration (1 week, 1 month, 1 year, etc.)
    • Availability → select which countries can purchase
    • Subscription Prices → click Add Subscription Price

Add the product to PurchaseKit

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

The product ID in PurchaseKit must exactly match the Product ID in App Store Connect.

Next step

Configure App Store Connect to send webhooks to PurchaseKit.