This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.
AnimationPrivilegeSegmentationTrigger

Privilege & Activation

Privilege & activation covers how customer-specific benefits are reflected on a pass, and how those benefits move from "available" to "active."

Privilege focuses on what a pass displays: tiers, statuses, discounts, points balances, or special perks tied to a customer's profile. This is the data layer — how privilege information is computed, stored, and surfaced as visible fields on the pass, and how it updates over time as a customer's status changes (e.g. moving from Silver to Gold).

Activation focuses on triggering those privileges: the mechanism that turns a stored benefit into something the customer can actually use, whether through a manual action, a pass update via the API, or a rule-based condition (purchase threshold, date, event).

Read together, the two pages cover the full path. A privilege is defined and stored on a single pass, an activation creates or updates that privilege across every pass in a segment, and each updated pass is then pushed to Apple Wallet and Google Wallet through the standard update pipeline.