In-app purchase setup

Create your subscription products in App Store Connect so users can purchase them in your app.

#Create a subscription group

Subscription groups let users upgrade or downgrade between plans without being charged twice. Each app needs one group.

1. Open your app in App Store Connect.
2. Go to Subscriptions under In-App Purchases in the sidebar.
3. Click the + next to Subscription Groups.
4. Enter a reference name matching your app name (e.g., "My App").

#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 using reverse domain notation: com.yourapp.pro.annual.

1. Click Create.
2. Set the Subscription Duration (1 week, 1 month, 1 year, etc.).
3. Under Subscription Prices, click Add Subscription Price and choose your price.

Repeat for each plan (e.g., com.yourapp.pro.monthly and com.yourapp.pro.annual).

#Submit for review

Your first subscription must be submitted with a new app version. After that, additional subscriptions can be submitted directly from the Subscriptions page.

1. Go to your app version page in App Store Connect.
2. Scroll to In-App Purchases and Subscriptions and add your subscription.
3. Submit the version for review.

A review screenshot is required. It must be a JPEG at one of Apple's accepted device dimensions. PNGs may fail with a misleading "dimensions are wrong" error due to file size.

Ruby Native captures screenshots on an iPhone 16 Pro Max simulator. If uploading manually, take a simulator screenshot and convert to JPEG before uploading.

If you're using Ruby Native's screenshot pipeline, the review screenshot is uploaded automatically when you publish your screenshots.

#Sync your products

After creating your products, go to your app's Purchases tab in the Ruby Native dashboard and click Sync. This pulls your product IDs so you can copy them into your paywall HTML.