How to add in-app subscriptions to an iOS app

Subscriptions are one of the most popular monetization strategies for today’s mobile apps. With predictable recurring revenue, developers can focus on continuous improvements and new features, while users enjoy apps that evolve and expand over time. Apple supports this model by reducing their commission to 15% after the first year, rewarding developers who build lasting relationships with their subscribers.

What you’ll learn in this iOS in-app purchases series

With this article, we start our comprehensive series of tutorials on integrating in-app purchases into an app. Here’s what we’ll be covering:

1. iOS in-app purchases, part 1: App Store Connect and project configuration
2. iOS in-app purchases, part 2: initialization and purchases processing
3. iOS in-app purchases, part 3: testing purchases in Xcode
4. iOS in-app purchases, part 4: server-side receipt validation
5. iOS in-app purchases, part 5: the list of SKError codes and how to handle them

In this part we will learn how to:

• Create purchases in App Store Connect
• Configure subscriptions: set a duration, price, and trial periods
• Get a list of purchases in-app

How to set up iOS in-app purchases: Prerequisites

Before implementing your in-app purchases you have to:

• Pay for the Apple Developer account as a natural person or an entity.
• Accept all the agreements in App Store Connect. You’ll receive banner notifications inside App Store Connect whenever Apple updates them, which they usually do a couple times per year

How to create iOS in-app purchases in App Store Connect

Let’s assume that our app will have two types of subscriptions: monthly and annual. Each of them will have a 7-day free trial.

Step 1: How to create a subscription group

First of all, we need to create a subscription group.

What is a subscription group? A subscription group is a set of subscriptions with an essential feature: the user cannot activate two subscriptions at the same time from the same group.

All introductory offers, such as trial subscriptions, are applied directly to the entire group. Groups serve to separate business logic in the application.

​​To create a subscription group:

1. On the application page in App Store Connect, open the Subscriptions tab.
2. Create a Subscription Group by clicking the plus button or by clicking Create if the list is empty.

Let’s name the group “Premium Access.”

‍Step 2: How to add individual subscriptions

Once the subscription group is ready, add the subscriptions by hitting Create.

Fill out the subscription details:

• Reference Name is the title of your subscription in App Store Connect, as well as in Sales section and the reports
• Product ID is a unique product identifier, which is used in the application code

Pro tip: I would recommend choosing a simple Product ID name, something that is easily recognizable in other contexts. It’s good to include subscription duration to help differentiate products when reviewing analytics later.

Add the second product just like you added the first. In the end, the interface of the subscriptions section will look like this:

How to configure subscription pricing and duration

We added the subscription products, but they can’t be used yet. The status column for each should be showing an error, “Missing Metadata”. It means we still haven’t added the information about pricing and subscription duration. Let’s fix that now.

Setting up subscription duration

Click on the product to configure it. Here we need to choose a Subscription Duration. Choose 1 month or 1 year, depending on the product.

How to set subscription prices

Then go lower to the Subscription Prices menu and click Add Subscription Price.

You can flexibly set prices depending on the country, but in this case we’ll rely on one global price, set in USD, and Apple will adjust it for the different currencies.

Important note: This adjustment process isn’t entirely transparent as to how Apple calculates the conversions. You might consider changing the price manually to account for regional expectations in your target market.

When the duration and the prices are set, hit the Save button on the subscription page.

How to enable free trials for iOS subscriptions

One of the most popular ways to increase subscriptions is a free trial.

What is a free trial? A free trial enables the user to demo the premium features of the app for free, but they are opting into signing up for the subscription automatically at the end of the trial period. To prevent being charged at the end of the trial period, the user would need to cancel the subscription in Settings before the trial period expired.

Developers love free trials because they work well. Let’s learn how to enable them.

Step-by-step free trial setup

Click (+) next to the title and choose Create Introductory Offer from the list:

‍

Set the countries and regions you want it to be enabled for:

‍

Choose the offer duration. You can set No End Date if you don’t want to limit yourself:

‍Understanding iOS subscription offer types

In the last step, you need to select an Offer Type.

As you can see in the next screenshot below, there are three types:

• Pay as you go: the user pays a reduced price during the initial period and then becomes a regular subscriber with standard prices.
• Pay up front: the user pays a fixed amount of money up front and unlocks functionality to use the app during the determined period, and then also becomes a regular subscriber.
• Free trial: unlocks functionality in the app for the trial period at no cost, and at the end of the trial period the user automatically subscribes at the subscription price.

Let’s choose the third one and set the duration for one week.

Save the settings and go to the next step.

How to get the list of products in your iOS app

Let’s check if the mobile app sees the purchases and then lay the groundwork for further implementation of in-app purchases.

This observable object allows us to initialize it at app startup and inject it into our environment to make it available everywhere. It’s a good practice to have a manager type to deal with StoreKit in one place.

import Foundation
import OSLog
import StoreKit

@Observable
final class IAPSubscriptionManager {
  private(set) var subscriptions: [Product] = []
  
  private let logger = Logger(subsystem: "io.adapty.MovieMania", category: "IAP Helper Service")
  private let identifiers: [String] = ["movie.mania.pro.1y", "movie.mania.pro.1m"]
  
  @MainActor
  func getProducts() async {
    
  }
}

The product identifiers are useful, but you need actual Product objects to show and process subscriptions. These objects contain the names, localized prices, durations, and other info that you’ll need to display on your paywall.

To get this information, we need to request for Product objects. Fill in the getProducts() method with the following:

@MainActor
  func getProducts() async {
    do {
      subscriptions = try await Product.products(for: identifiers)
      logger.info("Found \(subscriptions.count) products.")
    } catch {
      logger.error("Products could not be fetched: \(error.localizedDescription)")
    }
  }

If the async operation is successful, the method will return a list of Product objects. You should see the following log output:

Found 2 products.

However, if there is an error, review the log output to see what is wrong. This could mean you missed a step in the configuration of the products in App Store Connect.

What’s next in this iOS in-app purchases tutorial series

Great job! You’ve successfully set up your iOS in-app purchases in App Store Connect and created the foundation for fetching products in your app.

The next article will be focused on how to make in-app purchases: open/close transactions, handle errors, validate the receipt, and more.

If you liked this article, give us a ⭐ on GitHub!