Skip to content
Last updated

Welcome to PERS

PERS (Phygital Experience Rewards System) is a comprehensive SaaS loyalty and rewards platform designed to help businesses create engaging customer experiences through flexible token-based reward programs.

What is PERS?

PERS is a multi-tenant, cloud-native loyalty platform that enables businesses to:

  • Create Custom Reward Programs - Design tailored loyalty campaigns with flexible token systems
  • Multi-Business Collaboration - Enable partner ecosystems and cross-business rewards
  • Enterprise-Grade Security - Complete data isolation and security for each tenant organization
  • Real-Time Operations - Instant token transactions and balance updates
  • Seamless Integration - RESTful APIs for easy integration with existing business systems
  • Comprehensive Analytics - Track engagement, performance, and program effectiveness

Platform Overview

Platform Architecture

PERS operates as a comprehensive ecosystem where businesses can create sophisticated loyalty programs that engage customers across multiple touchpoints. The platform supports various reward mechanisms including token distribution, campaign participation, and cross-partner redemptions.

Core Components

Multi-Tenant Architecture

Each business operates as an independent tenant with complete data isolation and custom configuration capabilities.

Token System

Flexible token management supporting Credits, Rewards, and Status tokens with comprehensive lifecycle management:

  • Token creation and distribution
  • Real-time balance tracking
  • Secure transfers between users
  • Controlled token burning for deflationary mechanics

Campaign Management

Sophisticated campaign system enabling businesses to create engaging reward experiences:

  • Core Campaigns - Primary campaign creation and management
  • Campaign Tags - Organization and categorization system
  • Campaign Tokens - Reward configuration and distribution rules
  • Campaign Triggers - Automated activation based on user actions
  • Campaign Engagements - B2B partnership and collaboration features
  • Campaign Claims - Secure reward distribution with audit trails

Transaction Processing

Comprehensive transaction management with:

  • Token minting and burning operations
  • Secure peer-to-peer transfers
  • Real-time balance updates
  • Complete audit trails for compliance

Redemption System

Flexible token exchange enabling:

  • Conversion between different token types
  • Reward catalog integration
  • Partner ecosystem redemptions
  • Custom exchange rules and rates

Getting Started

1. Authentication

PERS supports multiple authentication methods:

  • Business API Keys - For business-level operations
  • Admin Authentication - For tenant administrative functions
  • User Authentication - For end-user operations
  • System Integration - For automated platform interactions

2. Basic Workflow

  1. Tenant Setup - Configure your organization's loyalty program
  2. Token Configuration - Define token types and rules
  3. Campaign Creation - Build engaging reward campaigns
  4. User Participation - Enable customers to earn and redeem tokens
  5. Analytics & Optimization - Monitor performance and iterate

3. Integration Patterns

  • RESTful APIs - Standard HTTP endpoints for all operations
  • Real-Time Events - Webhook integration for event-driven architectures
  • Secure Authentication - JWT-based security with role-based access control
  • Multi-Environment - Support for testnet and production deployments

API Architecture

Resource-Based Design

PERS follows RESTful principles with intuitive resource naming:

  • /campaigns - Campaign management operations
  • /tokens - Token system operations
  • /transactions - Transaction processing
  • /users - User account management
  • /businesses - Partner ecosystem management

Security & Compliance

  • Role-Based Access Control - Fine-grained permissions system
  • Data Encryption - End-to-end encryption for sensitive data
  • Audit Trails - Complete transaction history for regulatory compliance
  • Multi-Tenant Isolation - Secure data separation between organizations

Performance & Scalability

  • Cloud-Native Architecture - Built for high availability and scalability
  • Real-Time Processing - Instant transaction confirmation and balance updates
  • CDN Integration - Global content delivery for optimal performance
  • Optimized Queries - Efficient database operations for large-scale deployments

Use Cases

Retail Loyalty Programs

Create point-based systems where customers earn tokens for purchases and redeem them for discounts or products.

Multi-Brand Partnerships

Enable collaborative programs where customers can earn tokens from one business and redeem them with partners.

Event-Based Rewards

Configure campaigns that automatically reward users for specific actions like social media engagement or product reviews.

Gamification Systems

Build status-based programs with different token types representing levels, achievements, or exclusive access.

Next Steps

  1. Explore the API - Browse the endpoint documentation to understand available operations
  2. Authentication Setup - Configure your API access and security credentials
  3. Test Environment - Use our testnet environment to experiment with the platform
  4. Integration Planning - Plan your loyalty program architecture and integration points
  5. Go Live - Deploy your loyalty program and start engaging customers

Support & Resources

  • API Reference - Comprehensive endpoint documentation
  • Integration Guides - Step-by-step implementation examples
  • Best Practices - Recommendations for optimal platform usage
  • Developer Community - Connect with other developers building on PERS

Ready to build engaging loyalty experiences? Start exploring our API endpoints to discover how PERS can transform your customer engagement strategy.