App Store Subscription Entitlements
Implement and verify iOS subscription purchase, renewal, restore, expiration and refund with StoreKit and App Store server evidence. Use for entitlement synchronization and sandbox acceptance.
Write the product-to-entitlement mapping before wiring the purchase UI. Record the subscription group, environment, app identity, product IDs, internal account binding and which plan capabilities each verified product grants. Specify the display and access behavior for pending purchase, active service, billing grace, expiration and revocation. Cancellation of renewal does not generally mean the current paid period ended. ## Key Points - [StoreKit current entitlements](https://developer.apple.com/documentation/storekit/transaction/currententitlements?changes=_7) - [StoreKit Transaction lifecycle](https://developer.apple.com/documentation/StoreKit/Transaction?changes=l_10) - [Server notification V2 signed response](https://developer.apple.com/documentation/appstoreservernotifications/responsebodyv2.md) - [Apple sandbox testing](https://developer.apple.com/documentation/storekit/testing-in-app-purchases-with-sandbox.md)
skilldb get mobile-app-skills/app-store-subscription-entitlementsFull skill: 30 linesApp Store Subscription Entitlements
Write the product-to-entitlement mapping before wiring the purchase UI. Record the subscription group, environment, app identity, product IDs, internal account binding and which plan capabilities each verified product grants. Specify the display and access behavior for pending purchase, active service, billing grace, expiration and revocation. Cancellation of renewal does not generally mean the current paid period ended.
Process evidence from device and server
Use StoreKit's verified results when observing a purchase. A pending or cancelled result does not grant access. Start listening for transaction updates early, restore current access on launch using currentEntitlements as applicable, and finish a verified transaction after delivering or durably recording its effect. Provide a user-initiated restore or synchronization path if appropriate. When using an internal account, bind the purchase to the verified app/account context, including appAccountToken where the integration supplies one. Resolve ambiguous ownership rather than attaching it to the latest signed-in user.
For server-backed features, verify the signature and expected environment and app identity of App Store Server Notifications V2, including signed transaction and renewal data used for decisions. Base64URL decoding does not verify a signature. Use a supported verifier and established Apple trust configuration. Store transaction identifiers and reconcile state idempotently; repeated or out-of-order notifications must not regrant a revoked subscription or revoke a more recent valid one. Confirm ambiguous or missing state through the appropriate App Store server API and preserve the evidence timestamps.
Verify the whole lifecycle without live charges
Use the project's local StoreKit tests for deterministic client behavior and authorized Apple sandbox products and accounts when verifying server and device integration. Keep sandbox and production identifiers, trust/environment rules and entitlement storage separated. Do not test with a live customer subscription. Exercise initial purchase, pending purchase, renewal, expiry, an app reinstall or second test device, and a refund or revocation. Confirm that restoring purchases does not create a second billing action.
Replay notifications and reorder renewals and revocations in a test fixture, then check protected feature access through its normal entry point. Try wrong-environment and unverified evidence and require no access changes. Record the specific environment, product and anonymized account identity, transaction order, resulting access and whether each observation was a local fixture or real sandbox receipt.
References and rights
- StoreKit current entitlements
- StoreKit Transaction lifecycle
- Server notification V2 signed response
- Apple sandbox testing
Original SkillDB instructions under LicenseRef-SkillDB-Content. References were checked 2026-11-13 and used for technical verification.
Install this skill directly: skilldb add mobile-app-skills
Related Skills
Bixby Voice Capsule Development
Design a Bixby capsule with explicit actions, concepts, spoken training examples and local or simulator acceptance tests. Verify supported Developer Studio access before promising deployment.
Game Economy Design
Use this skill when designing virtual economies, progression systems, reward loops, or monetization structures for mobile games. Covers currency design, sink/faucet balancing, gacha mechanics, player spend segmentation, and live economy tuning. Trigger keywords: virtual currency, game economy, progression, gacha, loot box, IAP, monetization, reward loop, currency sink, whale, pay-to-win, economy balancing, pity timer.
Live Ops
Use this skill when planning live operations for mobile games after launch, designing content calendars, building battle passes or season passes, creating limited-time events and offers, segmenting players for targeted content, or managing update cadence. Trigger keywords: live ops, live operations, battle pass, season pass, limited-time event, content calendar, player segmentation, live service, hotfix, patch notes, live game.
Mobile Analytics
Use this skill when designing analytics systems for mobile apps, selecting analytics tools, defining event taxonomies, analyzing retention and funnels, or setting up crash monitoring and attribution. Trigger keywords: analytics, events, tracking, retention, cohort, funnel, DAU, MAU, attribution, SKAN, Crashlytics, A/B testing, feature flags, mobile metrics.
Mobile Development
Use this skill when advising on mobile app architecture, native vs cross-platform decisions, offline-first design, push notifications, deep linking, performance optimization, mobile security, or CI/CD pipelines for iOS and Android. Trigger keywords: mobile app, iOS, Android, React Native, Flutter, Swift, Kotlin, mobile architecture, offline-first, push notifications, deep linking, mobile CI/CD, Fastlane, mobile performance.
Measure Mobile Energy, Network and Background Location Cost
Compare energy, wakeups, location accuracy and network cost for mobile background work. Use on Android or iOS when changing location refresh, batching, caching or synchronization behavior.