Purpl Documentation
Core concepts
Separate the responsibilities of products, entitlements, purchase configuration, catalogs, and paywalls.
Product
A sellable item registered in App Store Connect or Google Play Console. The store is always authoritative for price and purchase availability.
Entitlement
Access to an app capability. Multiple products can grant one entitlement, and one product can grant multiple entitlements.
PurchaseConfiguration
The registry of every app product, entitlement, and product-to-entitlement mapping. It includes legacy products because restoration and entitlement calculation depend on them.
PurchaseCatalog
The products and display order for one sales context. Removing a discontinued product from a catalog does not revoke access for existing customers.
Paywall
The UI that presents a catalog and handles selection, purchase, and restoration. Your app owns navigation, tabs, toolbars, and close buttons.