InAppPurchaseKit Setup

Setting up the Products in App Store Connect

Create a New App in App Store Connect

At first, we need to create a new App in App Store Connect. Go to Apps (opens in a new tab) in App Store Connect and press on the Plus Button.

Next:

1. Enter the App Name
2. Select your App's Primary Language
3. Select your App's Bundle ID
4. Enter the SKU (Stock Keeping Unit, only visible to you) for your App
5. Select Full Access
6. Press Create

Create a New Subscription Group

In the Subscriptions tab, press on the Create to create a new Subscription Group.

Enter a "Premium" for the Subscription Group and press Create.

In the App Store Localization Section, press on Create.

Here:

1. Enter the Subscription Group Name
2. Select Use Custom Name and enter App's name. (You might want to change the App's Name later to something like "MyCookbookApp - Best Recipies" and we wouldn't want that to change the Subscriptoins Name)
3. Press Create

Add a Yearly Subscription

In the Subscriptions Section, press on Create.

Here:

1. Enter a Reference Name (Only visible to you)
2. Enter a product ID. It is recommended to follow RevenueCat guidelines to make it easily recognizable using following format: app_price_duration.

After creating the subscription, Select the Subscription Duration and click on Set UpAvailability.

Select all the countries you want your subscription to be available in and press Done.

Scroll down to the Subscription Prices section and press on Add Subscription Price.

Enter your region, price that you want to charge for your subscription and press Save.

If you want your subscription to be cheaper/more expensive dependindg on the region, you can select that here. When you're done press on Next.

Next, scroll down to App Store Localization and press on Add Localization.

Enter the Display Name and Description for your subscription and press Add. (It is recommended to use the same Display Name and Description)

Then, add a Reviewer Screenshot, which should display your App's Paywall. It is required for the review process, but for now we can just use placeholder image. You can download one here.

Press on Save

Add a Monthly Subscription

Back in the Subscription Group Overview, press on the Blue Plus Button to add a new Subscription.

Follow the same steps as in the Yearly Subscription to create a Monthly Subscription.

If everything is set up correctly, you should see two subscriptions in the Subscription Group Overview:

Add a Life-Time Access Product

Here we will add a one-time purchase to grant the user a lifetime access to the app.

In the Sidebar, select In-App Purchases, press on Create.

In the Dialog:

1. Select Non-Consumable
2. Enter a fitting Reference Name
3. Enter a Product ID

In App Store Localization enter Lifetime Premium Access. Select Availability, Pricing, and Review Screenshot the same way as with the Subscriptions.

Create an App-Specific Shared Secret

In order for RevenueCat to communicate with App Store Connect, we need to create an App-Specific Shared Secret. In the Sidebar select App Information, scroll down to App-Specific Shared Secret and press on Manage.

Press on Generate.

Write down the Shared Secret and press Done.

Generate a .p8 IAP Access Key

Go to the In-App Purchase (opens in a new tab) Section in App Store Connect > Users and Access > Integrations

Press on the Plus Button to create a new Key

Enter a Key Name and press Generate.

Next:

1. Download the .p8 Key
2. Write down the Key ID
3. Write down the Issuer ID

Generate a .p8 App Store Connect API Key

Go to the App Store Connect API (opens in a new tab) Section in App Store Connect > Users and Access > Integrations

Press on the Plus Button to create a new Key

Here:

1. Enter a fitting Key Name
2. Select App Manager
3. Press Generate

After generating the key:

1. Download the .p8 Key
2. Write down the Key ID
3. Write down the Issuer ID

Then, go to your App Store Connect Payments and Financial Reports (opens in a new tab) page and write down your Vendor Number, located in the top left corner.

Connect Products to RevenueCat

If you haven't already, create a RevenueCat Account (opens in a new tab).

In the RevenueCat Dashboard (opens in a new tab), create a new project.

Select App Store.

Here:

1. Enter the App Name
2. Enter the App Bundle ID
3. Enter the Shared Secret
4. Upload the .p8 Access Key
5. Enter the Key ID
6. Enter the Issuer ID
7. Press on Save Changes

Scroll down to App Store Connect API, then:

1. Upload the App Store Connect .p8 API Key.
2. Enter the Key ID
3. Enter the Issuer ID
4. Enter the Vendor Number
5. Press on Save Changes

Create Entitlements

Next, select Entitlements in the Sidebar and press on New.

Enter the Entitlement Name and enter its Description and press Add.

Create Products

In the Sidebar, select Products press on New. Select App Store.

Here, press on Import Products.

Select all products, and press Import.

After importing the products, you should see them in the Products section:

Go back to the Entitlements section and press on the entitlement.

Press on the Attach Button in Associated Products

Select the first product and press Add.

Select all the other products. In the end you should see all products in the Associated Products section:

Create an Offering & Packages

Creation of an Offering

In the Sidebar, select Offerings and press on New.

Here, enter a "default" as the Offering Identifier and a short Description. Press Save.

Package Creation

Press on the Offering we've just created.

In Packages, press on New.

Here:

1. Select Monthly as the Package Identifier
2. Enter a Description
3. Press Add

After creating a Monthly Package, we must attach a Monthly Product to it. Press on the Package, then Attach

Select the Monthly Product and press Attach.

Do the same for the Yearly and Lifetime packages. In the end, you should see all packages in the Offering:

Create a ReveueCat Paywall

In the Sidebar, select Paywalls and press on Add Paywall button for the Offering we've just created.

Select the second option.

In the Main Content section, enter:

1. Enter a Title (Won't be visible in the App)
2. Enter a Subtitle (Won't be visible in the App)

In the Packages section:

1. Select all Packages we created.
2. Select Monthly as the Default Package
3. Select Offer period in Package Name
4. Enter "Full Access for just {{ price_per_period }}" in Package details
5. Enter "First {{ sub_offer_duration }} free, then {{ price_per_period }}" in Package details for an introductory offer
6. Enter #3774E6 for Background and #FFFFFF for Text

In the Call to Action section:

1. Enter "Subscribe Now" in Call to action
2. Enter #3774E6 for Background and #FFFFFF for Text

In the Footer Links section:

1. Enter your Terms of Service URL
2. Enter your Privacy Policy URL

Press on Create Paywall.

Connect RevenueCat with our App

Now, we'll copy the a RevenueCat API Key to our App to be able to show our Offerings via our Paywall.

Back in the RevenueCat Dashboard, select API Keys in the Sidebar.

In the Public app-specific API keys section, press on Show Key. Write down the API Key.

In Xcode, go to Targets > InAppPurchaseKit > Config > RevenueCat-Info and paste the API Key into the value property of the key REVENUECAT_API_KEY.

Test if everything is set up correctly

Run your app on a real device or a simulator. Select the Settings Tab. Press on Unlock Premium Features. If everything is set up correctly, you should be able to see the Paywall with the packages, that you've created.