Connect the Purpl service

• Register the app and Apple store in Purpl.
• Connect products to entitlements.
• Create a catalog and a paywall that uses it.

Server mode can load product and entitlement configuration from Purpl without a local PurchaseConfiguration. The SDK resolves the active configuration using the bundle identifier and paywall identifier.

import Purpl
import PurplUI

Purchases.configure(entitlementMode: .server)

PaywallView(paywallIdentifier: "standard") {
    PremiumMarketingContent()
}

Pass a local paywall configuration as fallbackConfiguration when a remote paywall should remain available during a network failure or an unsuccessful first request. Even in server mode, Purchases.configure must receive a local PurchaseConfiguration when this fallback is used.

import Purpl
import PurplUI

Purchases.configure(
    purchaseConfiguration,
    entitlementMode: .server
)

PaywallView(
    paywallIdentifier: "standard",
    fallbackConfiguration: PaywallConfiguration(
        catalog: standardCatalog,
        defaultProductIdentifier: yearlyProduct.productIdentifier
    )
) {
    PremiumMarketingContent()
}

The SDK presents a cached remote configuration first and refreshes it in the background. When no cache exists, it immediately presents the local fallback and requests the remote configuration. A successful response replaces the fallback. The SDK waits for the first server response and returns an error only when neither a cache nor a local fallback is available.