WrapFast Documentation

Get Started

In-App Purchases

Firebase

WishKit

AI Backend

Xcode Project

API Client

Support

Configuring App Store Connect

WrapFast comes with a preconfigured purchases flow of 3 products. In order to get this functional, you need to create them on App Store Connect.

For being able to do this, you need to have created an app.

Creating an app

You can create an app mannualy in the App Store Connect clicking on the + Button. The app Bundle Identifier may be already created by Xcode with the prefix XC, otherwise you will have to create it manually.

Since Xcode 15, you can create automatically an app directly to App Store Connect. To achieve this, in Xcode:

• Product > Archive

• Distribute App

  

• TestFlight & App Store

  

• Type the Name, SKU and language. Upload…

• Now you can see your app within App Store Connect:

<aside> ⚠️ If you receive a mail with this: ITMS-90078: Missing Push Notification Entitlement, just ignore it. It is a known bug from Apple side that may occur when using Firebase in your project. I won’t affect you at all.

</aside>

<aside> 💡 Do you want to learn ASO basics? This FREE book by Matteo Spada, creator of Astro ASO tool is the best way to learn the basics FAST: https://matteospada.gumroad.com/l/dzgmq

</aside>

Creating Products: Subscriptions and One Time Purchases

In App Store Connect, enter in your new app created. You are going to configure the products that will be purchased from your app.

In the left menu:

• Go to In-App Purchases. Click Create.
• Fill the fields. In the WrapFast example we use the identifier premium_one_time_purchase. If you set another different one, remember to change it in RevenueCat later.

• Configure Countries Availability.

<aside> ⚠️ If you are building a GPT Wrapper, uncheck the country China Mainland. Apple will reject it as it is forbidden these type of apps by Chinese laws.

</aside>

• Set Pricing

  

• Set Localization

  

• Save

Now do the same for Subscriptions. You can find them in the left menu:

• First create a Subscription Group.

  

• Create a Subscription Group Localization. This is mandatory!

• Then create a monthly subscription. In the WrapFast examples it is configured with the id premium_monthly

• Then select the Duration: 1 Month

  

<aside> ⚠️ Family Sharing is turned off by default. Mind that if you turn it on, you cannot set it off later. You’ll have to create a complete new product. Apple things… ¯\*(ツ)*/¯

</aside>

• Localize the product

  

• Save and to the same for Annual Subscription with id ****premium_annual

• You have to end up having this subs:

  

<aside> ⚠️ Don’t care so far about the Missing Metadata warning. Later on, before submitting your app to review, remember to upload a screenshot of every in-app purchase, like this:

</aside>

Creating a Shared Secret

We need to create a token called Shared Secret to set it later in the RevenueCat Dashboard. To do so, in App Store Connect:

• In the left menu, click in App Information
• Scroll down and spot App-Specific Shared Secret
• Click Manage and Generate
• Copy the token to a safe place.

Generating In-App Purchase Key

In order to allow RevenueCat communicate with StoreKit API, we need to generate a key. Todo so, in the App Store Connect do this:

• Click in Users and Access in the very top menu
• Click in Integrations
• Click in In-App Purchase
• Generate a Key

• Download the key file.

• If you already have an Issuer Id, copy it as well. You will need it later. It appears above the generated keys:

• If you haven't done so yet, you'll need to request access to the App Store Connect API. In that case, you will also need to generate a random App Store Connect API key. Access level or name of the key here doesn't matter, but the Issuer ID will not show unless a key has been generated.

  

RevenueCat 😺

WrapFast relies on the best existing framework to handle in-app purchases and subscriptions in the easiest and quickest way.

RevenueCat Documentation here

The WrapFast boilerplate comes out of the box with the following pre-configured example offering:

• An Entitlement named premium containing the Products:
  • Subcriptions:
    • Monthly Subscription named premium_monthly
    • Annual Subscription named premium_annual
  • A non-consumable One Time Purchase named premium_one_time_purchase
• An Offering named default that contains:
  • Packages containing the products listed above.
  • A RevenueCat Paywall

This means when you fetch the default Offering within the app, you get those Packages and you can display the Paywall associated to it.

When an user purchases one of the Products, he is granted with the Entitlement associated to that product. Therefore you can easily check if the user has an Entitlement active to display or not the Premium features within your app.

This logic comes already implemented in the WrapFast boilerplate and it is handled by this two managers:

PurchasesManager: Handles all the interactions with RevenueCat.

UserManager: Handles user’s state. In terms of purchases, isSubscriptionActive is the property used in the project to check whether to display premium features or not.

In order to get this functional, you need to sign up for free in RevenueCat and create a new project.

We will go through it in the following sections.

Adding an App Store app in RevenueCat

• Create a new project

• Click on Apps in the left menu and create an App Store app

• Fill the fields with the proper information:

  • App name
  • The bundle id. It must be the same as your app.
  • The Shared Secret previously created.
  • The Key previously generated.
  • The issuer id previously copied.

  

• Save Changes

Generating an API Key

Go to the Api Keys menu on the left and next to your App Name click Show Api Key. Copy it in a safe place, you will need it later to paste in the Xcode project.

<aside> 💡 You will have to paste the RevenueCat API key in Xcode in Const.Purchases.key within Constants.swift

</aside>

Creating Products

We need to add here the same products that we created in the App Store Connect.

• Click in Products on the left menu.
• Click + New