/storekit

Subscriptions

Auto-renewable subscription management with StoreKit 2.

Subscription Properties

if let info = product.subscription {
    let groupID = info.subscriptionGroupID
    let period = info.subscriptionPeriod  // .day, .week, .month, .year
}

Subscription Status

let statuses = try await Product.SubscriptionInfo.status(for: groupID)

for status in statuses {
    switch status.state {
    case .subscribed:        // Active - full access
    case .expired:           // Show resubscribe/win-back
    case .inGracePeriod:     // Billing issue, access maintained
    case .inBillingRetryPeriod:  // Apple retrying payment
    case .revoked:           // Family Sharing removed
    @unknown default: break
    }
}

Listen for Status Updates

for await statuses in Product.SubscriptionInfo.Status.updates(for: groupID) {
    for status in statuses { updateUI(for: status.state) }
}

Renewal Info

switch status.renewalInfo {
case .verified(let renewalInfo):
    renewalInfo.willAutoRenew       // Will subscription renew?
    renewalInfo.autoRenewPreference // Product ID for next renewal
    renewalInfo.expirationReason    // Why expired?
case .unverified: break
}

Expiration Reasons

Grace Period

if let expiration = renewalInfo.gracePeriodExpirationDate {
    // Show update payment method UI
}

Offers

Introductory Offer

if let intro = product.subscription?.introductoryOffer {
    intro.period       // Duration
    intro.displayPrice // Price
    intro.paymentMode  // .freeTrial, .payAsYouGo, .payUpFront
}

Promotional Offers

for offer in product.subscription?.promotionalOffers ?? [] {
    offer.id, offer.displayPrice, offer.period
}

// Apply with server-signed JWS
let result = try await product.purchase(
    confirmIn: scene,
    options: [.promotionalOffer(offerID: offer.id, signature: jwsSignature)]
)

Subscription Groups

Users have one active subscription per group. Use for tier levels (Basic/Pro/Premium) or billing periods (Monthly/Annual).

let activeStatus = statuses.filter { $0.state == .subscribed }.first

Family Sharing

Family Sharing transactions have appAccountToken == nil. Each family member has unique appTransactionID.

Enable: App Store Connect > Subscriptions > Enable Family Sharing

Tracking Status

extension StoreManager {
    var isSubscribed: Bool {
        get async {
            let state = try? await Product.SubscriptionInfo.status(for: "pro_tier").first?.state
            return state == .subscribed || state == .inGracePeriod || state == .inBillingRetryPeriod
        }
    }
}

Win-Back Offers

if renewalInfo.expirationReason == .didNotConsentToPriceIncrease {
    showWinBackOffer()
}