Skip to main content
Technology & EngineeringMobile App30 lines

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.

Quick Summary10 lines
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 lines
Paste into your CLAUDE.md or agent config

App 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

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

Get CLI access →

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.

Mobile App•29L

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.

Mobile App•556L

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 App•407L

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 App•435L

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.

Mobile App•351L

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.

Mobile App•30L