The core vocabulary used across the API and these guides. See Core concepts for how they fit together.

Identity and ownership

• User — a person / identity. Owns wallets and profiles; ownership is never stored on a card directly.
• Wallet — a points/rewards ledger account (an address plus custody). Its kind (personal, membership, treasury, bearer) is derived from its owner.
• Bearer wallet — a wallet with no owner yet (e.g. a card preloaded with rewards, waiting to be claimed).
• Treasury wallet — an organization's own funds wallet (no user owner).
• Profile — a user-owned public identity page. A card routes to a profile when tapped. Can be claimed or unclaimed, and locked if the issuing org membership lapses.

Cards

• Card — a tap-able credential; card type is one of nfc_card, virtual_card, or qr_card.
• Registry — the stable set of valid cards plus issuance config. Never personalized, never moves.
• Assignment / connection — the layer that records who holds a card right now and its personalization (name, image, profile route, holder freeze).
• Card model — a reusable card design template (images, print config, optional attached profile template). Purely visual/config, distinct from the card itself.
• Profile template — a profile-shaped template with {{ user.* }} / {{ org.* }} placeholders, rendered when a profile is generated on claim.
• Claim — binding an unclaimed card (to a wallet) or an unclaimed profile (via username + claim code) to a user.
• Effective frozen — a card is frozen if the registry freeze or the holder-level freeze is set; the registry freeze is dominant.

Organizations and membership

• Organization (org) — a tenant/brand that issues cards, runs activities, and defines tiers and rewards.
• Org-scoped — an entity tied to a specific organization. A missing org means platform-owned.
• Role — a member's role within an organization: owner, manager, or member.
• Membership tier — a named plan an org offers (slug, price, payment interval).
• Membership — a user's active join of an org at a tier, with its own membership wallet and validity window.
• Subscription — the user's own Davi plan (e.g. free/pro) with entitlements. Distinct from an org membership.

Rewards and activities

• Reward template — a versioned definition of a reward (points plus content such as a badge, certificate, coupon, or attachment; optional supply cap).
• Reward trigger — an automation rule mapping trigger scopes to a reward template, with a deduplication window.
• Trigger scope — a pattern like activity.checked_in:count:5 describing the condition that fires a trigger. (Not to be confused with OAuth scopes.)
• Activity — an event with capacity, a time window, and optional ticketing.
• Session — a timeslot within an activity.
• Proof — an immutable ledger record of an attendance/check-in.
• Feed — the user's paginated activity log.

Auth

• OAuth scope — a permission your app requests (e.g. profile:read), shown to the user at consent. See Scopes.
• Org-scoped token — a token obtained by token exchange that acts on behalf of an organization. See Org-scoped tokens.