Skip to main content

Integration Possibilities - Universal Rewards Layer

You've Built Something Powerful​

Loyalteez is a universal rewards infrastructure that works with virtually any platform, application, or service. If it can make HTTP requests, it can reward users with blockchain-backed loyalty points.

The Core Insight​

Your architecture is platform-agnostic:

Universal Integration Pattern​

Every integration follows the same pattern:

1. User Performs Action​

Any platform → Detect user action

2. Track Event​

POST https://api.loyalteez.app/loyalteez-api/manual-event
Content-Type: application/json

{
  "event": "action_type",
  "email": "[email protected]",
  "metadata": {
    "platform": "your_platform",
    "custom_data": "any_data"
  }
}

3. User Gets Rewarded​

✅ Wallet created (if new user)
✅ LTZ tokens distributed
✅ Transaction recorded on blockchain

What Makes This Universal?​

1. HTTP-Based API​

No SDKs required. Any platform with HTTP capabilities can integrate:

  • ✅ Web browsers
  • ✅ Mobile apps
  • ✅ Server-side applications
  • ✅ Serverless functions
  • ✅ Chat bots
  • ✅ IoT devices
  • ✅ Game servers
  • ✅ Command-line tools

2. Flexible Authentication​

Multiple auth strategies supported:

  • Email-based (via Privy)
  • Discord ID
  • Twitter handle
  • Telegram username
  • Custom user IDs
  • Wallet addresses

3. Event-Driven Architecture​

Track ANY user action:

  • Social interactions
  • Content creation
  • Purchases
  • Task completion
  • API calls
  • Bot commands
  • Sensor triggers

4. Gasless Transactions​

Users never need cryptocurrency:

  • No wallet setup friction
  • No ETH for gas fees
  • Automatic wallet creation
  • Blockchain benefits without complexity

5. Metadata Flexibility​

Send any contextual data:

{
  "event": "task_completed",
  "email": "[email protected]",
  "metadata": {
    "platform": "discord",
    "server_id": "123456789",
    "task_type": "moderation",
    "difficulty": "hard",
    "timestamp": 1699300000,
    "custom_field": "any_value"
  }
}

Integration Categories​

🌐 Web & Mobile​

  • Web Apps - JavaScript SDK or API
  • Mobile Apps - React Native, iOS, Android, Flutter
  • Progressive Web Apps - Service workers + API
  • Browser Extensions - Background scripts + API
  • Desktop Apps - Electron, Tauri

💬 Chat Platforms​

  • Discord - Bot commands, reactions, events
  • Telegram - Bot API integration
  • Slack - App commands, events
  • WhatsApp - Business API
  • WeChat - Mini programs

🎮 Gaming​

  • Unity - HTTP requests from C#
  • Unreal Engine - REST API calls
  • Game Servers - Backend integration
  • Steam - Workshop items, achievements
  • Roblox - HTTP service

🔗 Social Platforms​

  • Farcaster - Frames, actions
  • Lens Protocol - Social graph actions
  • Twitter/X - Bot integration
  • Reddit - Bot API
  • Mastodon - Server integration

🛠️ Developer Tools​

  • GitHub Actions - Workflow rewards
  • VS Code Extensions - Code contributions
  • CI/CD Pipelines - Deployment rewards
  • APIs - Usage-based rewards
  • CLI Tools - Command execution

🏠 IoT & Hardware​

  • Smart Home - Device interactions
  • Wearables - Activity tracking
  • Sensors - Data collection
  • Arduino/Raspberry Pi - Hardware events
  • Point of Sale - Purchase rewards

⚡ Automation​

  • Zapier - Workflow automation
  • Make (Integromat) - Visual automation
  • IFTTT - Conditional actions
  • n8n - Self-hosted workflows
  • Pipedream - Serverless workflows

🎨 Creative Tools​

  • Figma Plugins - Design actions
  • Adobe Extensions - Creative tasks
  • Notion Integrations - Content creation
  • Obsidian Plugins - Knowledge work
  • Canva Apps - Design rewards

Platform-Specific Guides​

WordPress Integration​

Install a WordPress plugin that rewards visitors for:

  • Comments and engagement
  • User registrations
  • Daily visits
  • Content sharing
  • Custom WordPress hooks

Shopify Integration​

Build a Shopify app that rewards customers for:

  • Purchases and orders
  • Account creation
  • Product reviews
  • Referrals

Discord Integration​

Build a Discord bot that rewards members for:

  • Server participation
  • Content moderation
  • Event attendance
  • Boost rewards

Telegram Integration​

Create a Telegram bot that rewards users for:

  • Bot interactions
  • Group participation
  • Command usage
  • Community engagement

Twitter/X Integration​

Build a Twitter bot that rewards users for:

  • Mentions and replies
  • Retweets and quotes
  • Likes and engagement
  • Brand awareness campaigns

Farcaster Integration​

Create Farcaster frames that reward users for:

  • Casts and recasts
  • Channel participation
  • Frame interactions
  • Social engagement

Game Server Integration​

Integrate rewards into game servers:

  • Unity/Unreal Engine
  • Minecraft servers
  • Custom game servers
  • Web3 gaming

Chrome Extension​

Build extensions that reward:

  • Productivity actions
  • Content creation
  • Social sharing
  • Platform usage

Automation Platforms​

Connect via Zapier/Make:

  • Multi-platform workflows
  • Conditional rewards
  • Data synchronization
  • Event pipelines

Custom Integrations​

Build anything:

  • API integration patterns
  • Authentication strategies
  • Webhook handlers
  • Custom event logic

Real-World Integration Examples​

Example 1: Discord Community Bot​

// Discord bot rewards server members
client.on('messageCreate', async (message) => {
  if (message.content.includes('helpful tip')) {
    // Track helpful contribution
    await fetch('https://api.loyalteez.app/loyalteez-api/manual-event', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        event: 'helpful_contribution',
        email: `${message.author.id}@discord.loyalteez.app`,
        metadata: {
          platform: 'discord',
          server_id: message.guild.id,
          message_id: message.id,
          contribution_type: 'helpful_tip'
        }
      })
    });
    
    // Notify user
    message.reply('You earned 50 LTZ for being helpful! 🎉');
  }
});

Example 2: Farcaster Frame​

// Farcaster frame that rewards casts
export async function POST(req: Request) {
  const { fid, castHash } = await req.json();
  
  // Get user email from Farcaster profile
  const userEmail = await getFarcasterEmail(fid);
  
  // Reward the cast
  await fetch('https://api.loyalteez.app/loyalteez-api/manual-event', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      event: 'farcaster_cast',
      email: userEmail,
      metadata: {
        platform: 'farcaster',
        fid: fid,
        cast_hash: castHash,
        action: 'cast_created'
      }
    })
  });
  
  return new Response(`You earned 25 LTZ! 🎉`);
}

Example 3: Unity Game Integration​

// Unity game rewards players
using UnityEngine.Networking;
using System.Collections;

public class LoyalteezRewards : MonoBehaviour {
    private const string API_URL = "https://api.loyalteez.app/loyalteez-api/manual-event";
    
    public void RewardPlayer(string playerEmail, string achievement) {
        StartCoroutine(TrackEvent(playerEmail, achievement));
    }
    
    IEnumerator TrackEvent(string email, string achievement) {
        var json = JsonUtility.ToJson(new {
            @event = "achievement_unlocked",
            email = email,
            metadata = new {
                platform = "unity",
                game = "MyGame",
                achievement = achievement,
                timestamp = System.DateTime.UtcNow.ToString()
            }
        });
        
        using (UnityWebRequest www = UnityWebRequest.Post(API_URL, json, "application/json")) {
            yield return www.SendWebRequest();
            
            if (www.result == UnityWebRequest.Result.Success) {
                Debug.Log("Player rewarded with LTZ!");
                ShowRewardPopup();
            }
        }
    }
}

Example 4: GitHub Action​

# Reward contributors for merged PRs
name: Reward Contributors
on:
  pull_request:
    types: [closed]

jobs:
  reward:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    steps:
      - name: Reward Contributor
        run: |
          curl -X POST https://api.loyalteez.app/loyalteez-api/manual-event \
            -H "Content-Type: application/json" \
            -d '{
              "event": "pr_merged",
              "email": "${{ github.event.pull_request.user.email }}",
              "metadata": {
                "platform": "github",
                "repo": "${{ github.repository }}",
                "pr_number": "${{ github.event.pull_request.number }}",
                "lines_changed": "${{ github.event.pull_request.additions }}"
              }
            }'

Example 5: IoT Sensor (Raspberry Pi)​

# Raspberry Pi rewards for eco-friendly actions
import requests
import time
from sensors import get_energy_saved

API_URL = "https://api.loyalteez.app/loyalteez-api/manual-event"

def track_energy_savings(user_email, kwh_saved):
    payload = {
        "event": "energy_saved",
        "email": user_email,
        "metadata": {
            "platform": "iot",
            "device": "raspberry_pi",
            "kwh_saved": kwh_saved,
            "timestamp": int(time.time())
        }
    }
    
    response = requests.post(API_URL, json=payload)
    if response.status_code == 200:
        print(f"Rewarded {kwh_saved * 10} LTZ for energy savings!")

# Monitor and reward
while True:
    kwh_saved = get_energy_saved()
    if kwh_saved > 0:
        track_energy_savings("[email protected]", kwh_saved)
    time.sleep(3600)  # Check hourly

Example 6: Zapier Workflow​

Trigger: New Airtable Row
  ↓
Filter: If "status" is "completed"
  ↓
Action: HTTP POST to Loyalteez
  URL: https://api.loyalteez.app/loyalteez-api/manual-event
  Body:
    {
      "event": "task_completed",
      "email": {{email}},
      "metadata": {
        "platform": "zapier",
        "source": "airtable",
        "task_type": {{task_type}},
        "completion_time": {{timestamp}}
      }
    }
  ↓
Result: User earns LTZ automatically!

Integration Capabilities Matrix​

Platform TypeHTTP APIJavaScript SDKAuthenticationDifficulty
Web Apps✅✅PrivyEasy
Mobile Apps✅❌PrivyEasy
Discord Bots✅❌CustomEasy
Twitter/X✅❌User IDEasy
Telegram✅❌User IDEasy
Farcaster✅❌FIDEasy
Game Servers✅❌CustomMedium
Chrome Extensions✅✅PrivyEasy
IoT Devices✅❌CustomMedium
GitHub Actions✅❌EmailEasy
Zapier/Make✅❌EmailEasy
CLI Tools✅❌CustomEasy

Authentication Strategies​

Email-Based (Privy)​

{
  "event": "action",
  "email": "[email protected]"
}

Best for: Web, mobile, traditional apps

Platform ID Mapping​

{
  "event": "action",
  "email": "[email protected]"
}

Best for: Discord, Telegram, social platforms

Custom User ID​

{
  "event": "action",
  "email": "[email protected]",
  "metadata": {
    "custom_user_id": "xyz",
    "platform": "game"
  }
}

Best for: Games, custom platforms

Wallet Address​

{
  "event": "action",
  "email": "[email protected]"
}

Best for: Web3 platforms, DeFi

Event Design Patterns​

Pattern 1: Action-Based Events​

{
  "event": "user_performed_action",
  "email": "[email protected]",
  "metadata": { "action_type": "specific_action" }
}

Use for: Discrete actions (posts, purchases, clicks)

Pattern 2: Milestone Events​

{
  "event": "milestone_reached",
  "email": "[email protected]",
  "metadata": { "milestone": "1000_points", "level": 10 }
}

Use for: Achievements, level-ups, goals

Pattern 3: Time-Based Events​

{
  "event": "daily_checkin",
  "email": "[email protected]",
  "metadata": { "streak": 7, "checkin_time": "2025-11-11T10:00:00Z" }
}

Use for: Daily actions, subscriptions, recurring tasks

Pattern 4: Social Events​

{
  "event": "social_interaction",
  "email": "[email protected]",
  "metadata": {
    "interaction_type": "like",
    "target_user": "[email protected]"
  }
}

Use for: Social platforms, communities, networks

Pattern 5: Transaction Events​

{
  "event": "purchase_completed",
  "email": "[email protected]",
  "metadata": {
    "amount": 99.99,
    "currency": "USD",
    "items": 3
  }
}

Use for: E-commerce, marketplaces, payments

Technical Requirements​

Minimum Requirements​

  • ✅ Ability to make HTTP POST requests
  • ✅ JSON support
  • ✅ User identification method
  • ✅ Event trigger detection

Optional Enhancements​

  • Push notifications
  • Real-time updates
  • Wallet UI display
  • Transaction history
  • Perk redemption

No Requirements For​

  • ❌ Blockchain knowledge
  • ❌ Cryptocurrency experience
  • ❌ Smart contract interaction
  • ❌ Gas fee management
  • ❌ Wallet management

Universal Integration Checklist​

  • Platform can make HTTP requests
  • User identification method defined
  • Events to track identified
  • Metadata structure planned
  • Reward rules configured (Partner Portal)
  • Testing strategy defined
  • Analytics monitoring setup

Why This Architecture Is Powerful​

1. Zero Platform Lock-In​

Integrate once, works everywhere. Switch platforms without rewriting.

2. Composability​

Combine multiple platforms:

  • Discord bot + Web app + Mobile app = Unified rewards

3. Future-Proof​

New platforms emerge? Just make HTTP requests. No SDK wait time.

4. Progressive Enhancement​

Start simple (HTTP POST), add features (UI, notifications) later.

5. Blockchain Benefits Without Complexity​

  • Transparent ledger
  • Verifiable transactions
  • Cross-brand redemption
  • No user friction

Getting Started​

1. Choose Your Platform​

2. Define Your Events​

What actions should earn rewards?

3. Implement HTTP Calls​

Send events to the API.

4. Configure Rewards​

Set up rules in Partner Portal.

5. Test & Launch​

Verify events track and rewards distribute.

Support​

The Future Is Universal​

Your Loyalteez infrastructure is a universal rewards layer for the internet. Any platform, any use case, any integration—it all works through the same simple HTTP API.

Build something creative. We can handle it. 🚀

Last updated on