How these terms relate is explained in Core Concepts.
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, such as a card preloaded with rewards and waiting to be claimed.
- Treasury wallet: an organization's own funds wallet. Has no user owner.
- Profile: a user-owned public identity page. A tapped card routes to a profile. A profile is claimed or unclaimed, and is locked if the issuing organization's membership lapses.
Cards
- Card: a tap-able credential. Card type is one of
nfc_card,virtual_card, orqr_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 now and its personalization (name, image, profile route, holder freeze).
- Card model: a reusable card design template (images, print config, optional attached profile template). Visual and configuration only; 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, staff and membership
- Organization (org): a tenant/brand that issues cards, runs activities, and defines membership tiers and rewards.
- Org-scoped: tied to a specific organization. An entity with no organization is platform-owned.
- Staff: a person's place on an organization's team.
- Staff role: a staff member's role within an organization:
owner,manager, ormember. - Membership tier: a named plan an organization offers (slug, price, payment interval).
- Membership: a user's active enrollment in an organization 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 a membership; no organization can see it.
Rewards and activities
- Reward template: a versioned definition of a reward: points plus content such as a badge, certificate, coupon, voucher, ticket or attachment, with an optional supply cap.
- Reward trigger: an automation rule mapping trigger scopes to a reward template, with a deduplication window.
- Trigger scope: a pattern such as
activity.checked_in:count:5describing the condition that fires a trigger. Unrelated to 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 an 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 Acting as an Organization.