RevenueCat In-App Purchases
Learn how to integrate RevenueCat in-app purchase service
EasyApp provides RevenueCat as a subscription management service. RevenueCat has the following advantages compared to StoreKit2:
| Comparison Dimension | RevenueCat | StoreKit 2 |
|---|---|---|
| Cross-platform Support | ✅ Unified management across iOS, Android, Web, etc. | ❌ Limited to Apple ecosystem (iOS/macOS) |
| Advanced Features | 📊 Data analytics, A/B testing, Webhooks, etc. | 🛠️ Basic API only, advanced features require custom development |
| Compatibility | 📱 Compatible with StoreKit 1 & 2, supports legacy systems | 🍏 Only supports iOS 15+/macOS 12+ |
| Rich Paywalls | 🚀 Configure rich paywalls in RevenueCat without re-review | 🐢 Paywall UI changes require app re-submission and review |
| Real-time Data | 📊 Real-time in-app purchase data synchronization | 📊 Data only available the next day in App Store Connect |
RevenueCat's pricing is also very friendly - they only charge a 1% fee when your app's monthly revenue reaches $2,500. Below that, you can use it for free.
The following content until "Integrating RevenueCat Service" is consistent with the StoreKit2 documentation. If you have already configured in-app purchases in the StoreKit2 documentation, you can directly skip to "Integrating RevenueCat Service".
Before integrating in-app purchases, you must have a valid Apple Developer Program membership and have signed the Paid Applications Agreement

Friendly reminder: App Store Connect is internationalized and the webpage will automatically display internationalized content based on your browser language.
Our documentation will be primarily in English, but you can still find the corresponding operations in Chinese based on the screenshots in the documentation.
Adding In-App Purchases in App Store Connect
First Create an App
Before adding in-app purchases, you need to create your App first, which is mandatory. We log in to App Store Connect, click "Apps" at the top, then click the "+" button to create your App.

In the New App popup, you need to fill in the following information:
- Platform: Select your App's platform
The platform you expect to publish on. Choose iOS, and both iPhone and iPad can download (provided you need to adapt for iPad)
-
App Name: Your App name
-
Bundle ID: Your App's Bundle ID
You can select from the dropdown, please choose the Bundle ID that corresponds to your Xcode project.

-
Fill in SKU information (this information is only visible to you), you can fill in the App name
-
Access selection: Full Access
-
Click Create button
Recurring subscriptions depend on subscription groups, so you need to create a subscription group first.
Create Subscription Group
- Select
Subscriptionson the left side, click theCreatebutton to create a new subscription group

- Fill in your subscription group name, most are names like
Pro,Plus,VIP,Premium,Unlimited, etc. Then click theCreatebutton

- Fill in subscription group internationalization information. We'll use English/Chinese as examples, filling in the English subscription group name and description.

Subscription group internationalization information will automatically display the corresponding language in the AppStore based on the user's region.
The following image shows subscription group related information

- Step 1: Localization: Select the corresponding language
- Step 2: Fill in subscription group name
- Step 3: App Name Display Options select: Use Custom Name, because you may modify the App name later, so choose Use Custom Name here
- Step 4: Create to save

Using Chinese as an example

After creation, you can view and manage internationalization information here

Create Subscriptions Under Subscription Group
In most cases, the subscriptions we create are recurring subscriptions, which are common annual subscriptions (yearly payment/membership), monthly subscriptions (monthly payment/membership), or weekly subscriptions (weekly payment/membership).
So we'll use annual and monthly subscriptions as examples. Similarly, you can create weekly subscriptions. The steps are all the same.
Create Annual Subscription
1. Create Subscription Type

Next, the system will ask you to provide a reference name and product ID
We need to explain Reference Name and Product ID to help you better understand App Store Connect related knowledge
-
Reference Name: Reference Name will be used for App Store Connect and Apple's sales and trends reports, but will not be displayed to users in the App Store. It's recommended to use an easy-to-understand product description as the name, and the length must not exceed 64 characters.
-
Product ID: Product ID is a unique alphanumeric identifier used to access your product in development and sync with RevenueCat. Once you use a product ID for a product in App Store Connect, even if the product is deleted, that ID cannot be used for any of your other apps. It's recommended to stay organized from the beginning - we recommend using a unified naming scheme for all product identifiers, for example:
<app>_<price>_<duration>_<intro duration><intro price>
We further explain the above specification:
-
app (application prefix): This is a unique prefix exclusive to your application, because the same product ID cannot be used for any other apps you create in the future.
-
price: The fee you plan to charge for this product in the default currency.
-
duration (subscription duration): The duration of the regular subscription cycle.
-
intro duration (trial period duration): If there is a trial period, this represents the duration of the trial period.
- intro price (trial price): If there is a trial period, this represents the trial price in the default currency.
In this example, I want to set up an annual subscription priced at $69. Following this format, I set the product identifier as:
easyappswiftui_69_1y
Using a consistent naming scheme for product identifiers in App Store Connect can save you time in the future and make it easier to organize and understand your products just by the identifier.
2. Set Subscription Duration
After clicking Save in the previous step, we need to set the subscription duration. For annual membership, we select 1 year validity period.
Then set Availability
Availability is selecting which countries/regions your subscription service will be effective in.

Of course, we want all countries/regions to be able to use our subscription service, so we check all by default here.
Click the Save button to save

3. Set Subscription Prices
Scroll down the page to find Subscription Prices, click the Add Subscription Prices button to set subscription prices

In the popup, we need to set 2 pieces of information
- First: Select country/region
- Second: Select price

For country, we first select United States, to settle in US dollars
For price, we select $69
If you want to find more price options, click the See Additional Prices button to select your desired price

Then click the Next button

Next, you'll see another popup
In this popup, you can set different prices based on country/region. For example, I set mainland China to ¥128 RMB

Similarly, you can also click the See Additional Prices button to select your desired price
Here, App Store Connect is very thoughtful and will automatically calculate corresponding prices for other countries/regions based on the USD price you set, combined with current exchange rates.
After setting, click the Next button, then click the Confirm button
4. Set Subscription Internationalization Information
Next, we need to set up App Store localization information. These are the in-app purchase names and descriptions that users will see.
Continue scrolling down the page, find Localization, click the Add Localization button

We need to provide subscription display name and description. The subscription display name and description will be shown in the App Store and in users' subscription management settings.
Taking the annual subscription we just created as an example: our subscription name is Annual Subscription, and the subscription description is Unlimited access unlocks all features
In the documentation, we use English and Chinese as examples
First, set the English subscription display name and description
After filling it out, click the Add button

Then set the Chinese subscription display name and description
- Select Chinese
- Subscription display name: 年度订阅
- Subscription description: 解锁所有高级功能

After filling it out, click the Add button
After creation, you can view and manage internationalization information here

5. Add Review Information
Continue scrolling down the page to find Review Information
The final step in setting up in-app purchases in iOS is to add information for reviewers. This includes a screenshot and optional review notes. Developers often overlook screenshots, but you cannot submit a product for review without a screenshot.
- Screenshot: In-app purchase paywall for reviewers to view. During testing, you can upload any 640×920 blank image here. Before submitting for review, be sure to replace it with an actual paywall interface image.
- Review Notes: This is optional, used to explain anything related to in-app purchases to reviewers. (Most cases don't need to be filled)

During testing, you can download this image and upload it as a placeholder. Before submitting for review, be sure to replace it with an actual paywall image.

After setting up, click the Save button in the upper right corner to save. The annual subscription creation is now complete.
Next, we'll follow the steps for creating annual subscriptions to create monthly subscriptions.
Create Monthly Subscription
We return to the subscription group preview page, click the Subscriptions + button to create a monthly subscription

At this point, the steps are exactly the same as Create Annual Subscription.
You can refer to the steps in Create Annual Subscription to create monthly subscriptions
Of course, you can also create weekly subscriptions, quarterly subscriptions, and semi-annual subscriptions. The steps are all the same.
Remember to select the correct subscription duration here 😄

If you complete the entire process successfully, you should see the following page. All the subscriptions you created will be displayed here.

If you want to modify subscription information, you can click the subscription name to enter the subscription details page. Then modify the information you want.

We cannot modify the subscription's Product ID. Even if the product is deleted, that ID cannot be used for any of your other apps. This is the unique identifier for getting subscription information. If you're unsure, please refer to the Product ID explanation in here.
Create One-time Purchase (Lifetime Membership)
Creating one-time purchases doesn't depend on subscription groups. We return to the App preview homepage, click In-App Purchases, click the Create button to create a one-time purchase

In the popup, we need to fill in the following information:

- Type: Select
Non-Consumable, representing non-consumable goods
Here's an example to help you understand: Non-consumable goods can be understood as: for example, if we develop an image recognition App, after users purchase lifetime membership, they can use this feature permanently. No usage limit, no time limit.
Consumable goods: For example, if we set that users can purchase 100 recognition opportunities, then after users purchase, they can use this feature permanently. But after the usage is exhausted, users need to purchase again.
-
The filling of
Reference NameandProduct IDfollows the same rules as theReference NameandProduct IDfilling rules in Create Annual Subscription. -
Click the
Createbutton to create a one-time purchase and enter the one-time purchase details page
Similarly, we need to set the one-time purchase's Availability, Price Schedule, App Store Localization, Review Information according to the rules in Create Annual Subscription

Finally, don't forget to click the Save button in the upper right corner to save
After success, you can view and manage one-time purchases here

Congratulations 🎉🎉🎉, you have completed the creation of subscription in-app purchases and one-time purchases in App Store Connect.
Next, let's register a RevenueCat account (if you don't have one yet).
Integrating RevenueCat Service
RevenueCat account registration is very simple, you just need to fill in your information correctly according to the registration process. We won't go into detail here.
We will focus on how to integrate RevenueCat service.
New RevenueCat Registration Process
Test In-App Purchases
During development, in-app purchases are tested in the sandbox. No actual charges will be made during purchases.
Please use a real device for testing, not the simulator.
- First, we need to create a sandbox test account in App Store Connect's
Users and Access
If you already have a test account, follow the image below:

Click the + button to create a sandbox test account.
If you don't have a test account and are creating one for the first time, follow the image below:

In the subsequent popup, enter your test account information and click the Create button to save.

- Run the app on a real device and test in-app purchases
How to view subscription data in real-time?
Return to RevenueCat's Dashboard page, where you can see all your subscription information.
In the sandbox environment, you need to turn on the Sandbox data switch.

RevenueCat Common Errors

Usually, this is because your agreement in App Store Connect has not been signed or has issues.
You need to check if your App Store Connect Paid Applications Agreement is valid
Complete banking information Complete tax form information Complete compliance
RevenueCat Official Documentation also has detailed troubleshooting methods for this type of error.

Next Steps
Finally, it's strongly recommended that you check the App Store Connect Help documentation (App Store Connect Help Chinese Address) and RevenueCat Documentation to learn more about in-app purchases.
Old RevenueCat Registration Process (Deprecated)
Last updated on