Overview: Auditing App Store Monetization via Chat
Configuring In-App Purchases (IAP) and auto-renewable subscriptions in App Store Connect requires managing multiple interconnected assets: product identifiers, localized descriptions, subscription group hierarchies, pricing tiers, and review proof screenshots.
When developing an iOS app with an AI coding assistant (such as Cursor, Claude Code, Xcode with MCP, or Antigravity), you need to verify whether your store-side configuration matches your client-side StoreKit implementation before submitting for Apple App Review.
With FlightDeck, you can ask your AI assistant to audit your monetization catalog directly from chat. FlightDeck queries App Store Connect in read-only mode, inspects configured products, validates localized titles and prices, checks review screenshot status, and reports any missing requirements.
StoreKit Implementation vs. App Store Connect:
- FlightDeck MCP Capabilities: Audits remote App Store Connect resources (product IDs, pricing, localized copy, subscription group ranks, review screenshots) over Apple's REST API. Uses
subscription_group_localizations_listto inspect localized group names. - Client-Side StoreKit Code: Configuring products in App Store Connect does not write StoreKit code into your app. Your iOS app must implement StoreKit 2 (
Product.products(for:),product.purchase(),Transaction.updates) to present paywalls and handle transactions. - Approval Reality: Passing all inspectable configuration checks does not mean your products are approved. First-time in-app purchases must be submitted to Apple App Review alongside a new binary version and evaluated by Apple review staff.
The Primary Prompt: Monetization Catalog Audit
Connect your AI coding assistant to FlightDeck and paste the following prompt:
Please audit all In-App Purchases and subscriptions configured for [Your App Name] using FlightDeck:
1. Locate my app record and list all configured monetization products:
- Standalone IAPs (Consumables and Non-Consumables)
- Subscription Groups and Auto-Renewable Subscriptions
2. For each product, report:
- Product ID and Reference Name
- Type and Lifecycle Status (e.g., READY_TO_SUBMIT, MISSING_METADATA, APPROVED)
- Localized display names and descriptions
- Base pricing tier
- Review proof screenshot status (Present or Missing)
3. Highlight any missing configurations that would block Apple App Review submission.
4. Compare product IDs against our local StoreKit client code if available in this project.
What Happens Behind the Prompt
When you run this prompt, your assistant executes a read-only audit across Apple's monetization APIs:
Developer Prompt: "Audit all IAPs and subscriptions for [App]"
│
▼
[1. App Discovery & Product Catalog Fetch]
Assistant identifies appId and retrieves standalone IAPs (V2)
and subscription group containers
│
▼
[2. Subscription Group & Hierarchy Inspection]
Queries subscription products, group levels, and localizations
│
▼
[3. Asset & Review Screenshot Verification]
Checks whether required paywall proof screenshots exist
│
▼
[4. Structured Monetization Audit Report]
Categorizes products: Complete, Missing Metadata, Review Blockers
- Product Discovery: Your assistant queries App Store Connect for standalone in-app purchases (consumables and non-consumables) and subscription groups.
- Hierarchy & Level Inspection: For auto-renewable subscriptions, it verifies group membership and subscription tier ranks (e.g., Level 1 Pro vs. Level 2 Standard).
- Review Asset Audit: Inspects whether required review proof screenshots are uploaded for each item.
- Structured Audit Delivery: Summarizes your monetization catalog in chat, pointing out missing items and client code discrepancies.
What Your Assistant Delivers: The Monetization Audit Report
Your assistant synthesizes the results into an actionable summary:
App Store Monetization Audit Report
App: FocusFlow (Bundle ID: com.focusflow.ios)
============================================================
1. AUTO-RENEWABLE SUBSCRIPTIONS
------------------------------------------------------------
Group: "FocusFlow Premium Access" (ID: grp_901234)
• Localized Group Names: en-US ("FocusFlow Premium"), ja ("フォーカスフロー プレミアム")
Product 1: focusflow_monthly_sub
- Type: Auto-Renewable Subscription (1 Month, Level 1)
- Status: READY_TO_SUBMIT
- Price: $4.99 USD (Base Territory: USA)
- Display Name (en-US): "FocusFlow Monthly Premium"
- Review Screenshot: [x] Present (1290x2796 paywall screenshot uploaded)
Product 2: focusflow_yearly_sub
- Type: Auto-Renewable Subscription (1 Year, Level 1)
- Status: MISSING_METADATA
- Price: $39.99 USD
- Display Name (en-US): "FocusFlow Annual Premium"
- Review Screenshot: [!] MISSING
- Blocker: Requires an App Review proof screenshot before submission.
============================================================
2. STANDALONE IN-APP PURCHASES
------------------------------------------------------------
Product: focusflow_lifetime_unlock
- Type: NON_CONSUMABLE
- Status: READY_TO_SUBMIT
- Price: $79.99 USD
- Display Name (en-US): "Lifetime Pro Unlock"
- Description: "Unlock all current and future FocusFlow features forever."
- Review Screenshot: [x] Present
Product: focusflow_50_credits
- Type: CONSUMABLE
- Status: READY_TO_SUBMIT
- Price: $1.99 USD
- Review Screenshot: [x] Present
============================================================
STOREKIT CODE CONCORDANCE
------------------------------------------------------------
[x] focusflow_monthly_sub matches StoreKit product ID in StoreManager.swift
[x] focusflow_yearly_sub matches StoreKit product ID in StoreManager.swift
[x] focusflow_lifetime_unlock matches StoreKit product ID in StoreManager.swift
[!] Warning: StoreManager.swift references "focusflow_100_credits", but
App Store Connect only has "focusflow_50_credits" configured.
Understanding Apple's Monetization Hierarchy
Apple divides digital in-app monetization into four distinct product types:
1. Consumable In-App Purchases
Items depleted during use and repurchased multiple times (e.g., virtual currency, credits, export packs).
- Entitlement: Apple does not track consumables across device restores. Your backend database or local persistence tracks usage.
2. Non-Consumable In-App Purchases
Items purchased once that never expire (e.g., lifetime feature unlock, ad removal).
- Requirement: Apple Guideline 3.1.1 strictly mandates a working "Restore Purchases" button in your app's UI for non-consumables.
3. Auto-Renewable Subscriptions
Recurring periodic subscriptions (weekly, monthly, annual).
- Requirement: Every auto-renewable subscription must belong to a Subscription Group.
- Group Rules: A customer can only hold one active subscription per group at a time. Upgrades apply immediately; downgrades take effect at the next renewal date.
- Group Localizations: The group must have localized names that appear on Apple subscription management pages.
4. Non-Renewing Subscriptions
Fixed-period access (e.g., a 6-month sports pass) without automatic renewal.
Diagnosing Common Monetization Blockers
| Status / Error | Root Cause | Resolution |
|---|---|---|
MISSING_METADATA |
Product lacks a review proof screenshot, localized description, or price tier. | Ask your assistant: "Which metadata fields are missing on product [ID]?" Upload the missing screenshot or set pricing. |
Product.products(for:) Returns Empty in App |
Product ID mismatch between Xcode client code and App Store Connect, or Paid Applications agreement unsigned. | Verify product ID strings match verbatim. Check App Store Connect Agreements to confirm the Paid Applications contract is active. |
| First IAP Submission Rejected | First-time in-app purchases must be submitted attached to a new binary version. | When submitting version 1.0.0 for review, attach the new IAP products to the review submission container. |
| Review Proof Screenshot Missing | Apple requires a screenshot demonstrating where the product is purchased in the app UI. | Capture a paywall screenshot and upload it via FlightDeck. (See Uploading IAP Review Screenshots). |
Testing Monetization Before Release
Never test in-app monetization using production Apple IDs or live payment methods:
- Xcode StoreKit Testing (
.storekit): Create a StoreKit Configuration file in Xcode (File > New > File > StoreKit Configuration File) to test purchases, renewals, cancellations, and restores offline in the iOS Simulator. - Sandbox Testers on Physical Devices: Create Sandbox Tester accounts in App Store Connect under Users and Access > Sandbox Testers. Log in to the sandbox account under Settings > App Store > Sandbox Account on your test device.
- TestFlight Distribution: Builds distributed via TestFlight automatically use Apple's sandbox environment. In-app purchases can be tested freely by external testers without incurring real charges.
Follow-Up Prompts for Managing Products
Inspecting a Specific Subscription Group
Show me the detailed subscription hierarchy and localized group names for subscription group "FocusFlow Premium Access" on [Your App Name].
Checking Review Proof Assets
Check if all our in-app purchases and subscriptions have approved review screenshots attached. Report any products that still need a screenshot.
Related Documentation and Guides
- Configuring App Store Price Schedules and Free Tiers via MCP
- Uploading In-App Purchase Review Screenshots via FlightDeck MCP
- Pre-Flight App Store Submission Readiness Check: Automated Audit Guide
- Diagnosing and Fixing App Store Rejections with an AI Coding Assistant
- Apple Developer: In-App Purchase Overview
- Apple Developer: StoreKit 2 Documentation