This dictionary explains key concepts, entities, and processes within the PERS platform.
First, we set up all of the key components you need for your system to operate.
Tenant: You and your organization's program instance. Each tenant operates independently with complete data isolation and custom configuration within the PERS multi-tenant architecture.
User: Your customers who engage with the tokenization system through your front-end applications, mobile apps, or partner interfaces.
Admin: Administrative users with elevated permissions to manage tenant-level operations, configurations, and system oversight.
Platform: A third-party platform, software, or system that integrates with your PERS operations. Examples include CRM systems, booking platforms, EPOS systems, or e-commerce platforms.
Integration: The seamless communication layer between your existing platforms and PERS. Currently supports over 7,000 possible integrations through various APIs and webhooks.
API: RESTful application programming interfaces that enable secure communication and data exchange between PERS and external systems.
Project Key (Context ID): A Public unique identifier for your Tenant/Project context. It ensures that your requests are routed to the correct isolated environment. Required for all API calls but does not provide authentication.
Trigger: An event or action occurring in the real world or within connected platforms that sends a signal to PERS and automatically activates campaign participation or reward distribution.
Business: A real-world touchpoint or partner location within your PERS ecosystem. Examples include retail stores, restaurants, service providers, or any physical/digital location where users interact with your loyalty program.
Define the actions you want to encourage and the rewards you'll offer by creating the strategic frameworks for user engagement.
Token: PERS operates with flexible token types designed to optimize your loyalty strategy. The platform supports various token categories:
- Credits/Points: Basic digital currency tokens for standard transactions and accumulation
- Rewards: Tokens representing real-world experiences, products, or services (e.g., free beverages, exclusive experiences, merchandise)
- Status Tokens: Digital representations of achievements, memberships, or special recognition levels
Campaign: Strategic marketing initiatives that define available tokens, participation requirements, and trigger conditions for user engagement. Campaigns can be:
- Public Campaigns: Discoverable by all users without authentication
- Targeted Campaigns: Specific to user segments or business partners
- Time-Limited Campaigns: Active for defined periods with start/end dates
- Event-Based Campaigns: Triggered by specific user actions or external events
Campaign Tags: Organizational labels that categorize campaigns for easier discovery and management across your loyalty program catalog.
Campaign Tokens: Specific reward configurations linking token types and amounts to campaign participation outcomes.
Campaign Triggers: Automated activation rules that determine when and how campaigns become available to users based on predefined conditions.
Campaign Engagements: B2B relationship management features enabling multi-business collaboration and cross-partner reward programs.
Redemption: Exchange mechanisms that define how users can convert accumulated tokens into rewards, products, or services. Redemptions support complex rules including exchange rates, eligibility requirements, and partner network availability.
With your loyalty system live and campaigns active, all user engagement is automatically tracked and rewarded within PERS.
Balance: Real-time tracking of token holdings across all user accounts, supporting multiple token types simultaneously with instant updates from all transaction sources.
Wallet: Digital token storage where earned rewards are held. Each entity (users, businesses, tenants) maintains an isolated wallet with security controls.
Transaction: Comprehensive record-keeping system capturing all token movements and operations. Transaction types include:
- Mint: Creation of new tokens and addition to user accounts (reward distribution)
- Transfer: Secure movement of tokens between wallets (peer-to-peer or business-to-user)
- Burn: Permanent removal of tokens from circulation (typically following redemption or expiration)
Claim: User participation in reward programs. Claim processing supports multiple access levels:
- USER Claims: Direct customer reward claims through authenticated user interfaces
- BUSINESS Claims: B2B reward processing with business context attribution
- SYSTEM Claims: Automated claims triggered by integrated platforms and APIs
- ADMIN Claims: Administrative oversight and manual claim processing for special circumstances
Purchase: Secure payment processing system enabling users to top-up account balances through various payment methods, supporting premium features and additional token acquisition.
File Management: Secure asset storage and delivery system for campaign images, user avatars, and program-related media with role-based access controls.
Authentication & Authorization: Multi-level security supporting USER, BUSINESS, ADMIN, and SYSTEM access levels with JWT-based authentication.
Blockchain Integration: Multi-chain support for token operations including network configuration, smart contract deployment, and cross-chain compatibility.
Web3 Chains: Blockchain network management supporting multiple networks simultaneously with real-time status monitoring and gas optimization.
Smart Contracts: Automated blockchain-based contracts managing token operations with upgrade capabilities and event monitoring.
Webhooks: Real-time event notification system enabling integration with external platforms through secure callback mechanisms.
JWKS (JSON Web Key Set): Security infrastructure providing public keys for JWT token verification across the platform ecosystem.
All of this can be created and managed within your PERS dashboard and through RESTful APIs.