Documentation

Glossary

Definitions of the terms used across the Davi API and developer docs.

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, 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 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, or member.
  • 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:5 describing 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.