Documentation menu

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.