Skip to main content

Partner Portal Guide

The Partner Portal is your command center for managing your Resonance loyalty program.

Getting Started​

Create Your Account​

  1. Visit partners.rsnc.network
  2. Sign up with Google, GitHub, email, or wallet via Privy
  3. Complete the onboarding wizard to set up your brand profile

Find Your Brand ID​

Your Brand ID is essential for bot setup and API integration:

  1. Go to Settings → Account
  2. Copy the Brand ID (starts with 0x, 42 characters)

Dashboard​

Your at-a-glance view of program health:

  • Total RSNC distributed and current balance
  • Active users and engagement trends
  • Activity feed with recent events
  • Inventory alerts for low-supply perks
  • Quick stats for daily/weekly performance

Automation & Events​

Configure what actions get rewarded and how rewards are distributed.

Create Event​

  1. Click Create Event
  2. Set event name and type
  3. Configure reward amount (RSNC per event)
  4. Set cooldown (hours between claims per user)
  5. Set max claims (per-user and event-wide limits)
  6. Choose detection method (Discord, Telegram, HTTP webhook, etc.)
  7. Enable the event

Event Settings​

SettingDescription
Reward AmountRSNC given per event
CooldownHours between claims per user
Max Claims Per UserPer-user lifetime limit
Max Total ClaimsEvent-wide limit
Detection MethodHow events are triggered
EnabledActive or inactive

Webhook Integration​

Configure webhook URLs for event triggers:

  1. Go to Integrations → Webhooks
  2. Set your webhook URL
  3. Events are sent as POST requests with HMAC signatures
  4. Use the webhook secret for signature verification

Budget Forecasting​

The automation config includes budget estimation — see projected RSNC spend based on your event configuration and expected activity levels.

Perk Collections​

Create NFT-based rewards that users can claim with RSNC credits.

Create Collection​

  1. Go to Perks → Create Collection
  2. Set collection details:
    • Name and Description
    • Image for the perk card
    • Burn Price (RSNC required to claim)
    • Supply (total available)
  3. Collection is created on-chain via PerkNFT contract
  4. Appears in the Perks Marketplace immediately

Perk Lifecycle​

  • Active — Available for claiming
  • Low Stock — Supply warnings triggered
  • Sold Out — Visible but not claimable

Analytics​

Track your program's performance with advanced analytics:

Overview Metrics​

  • RSNC distribution over time
  • Active users by period
  • Event breakdown by type
  • Top users and engagement leaders
  • Perk redemption rates

Advanced Analytics​

  • Daily snapshots — Historical performance data
  • Health metrics — Program health scores
  • Perk lifecycle tracking — Claim velocity and supply depletion

Integrations​

Discord​

  • Add bot to your server
  • Role sync — Automatically assign Discord roles based on RSNC holdings
  • Advanced role management — Configure role thresholds and multipliers
  • View connected servers and their configurations

Telegram​

  • View connected groups
  • Configure bot settings

Shopify​

Connect your Shopify store via the Shopify App:

  • Automatic reward distribution on purchases
  • Storefront widget for customer engagement
  • Discount code generation for perk redemptions

Farcaster​

Mini app support:

  • Manifest file at /.well-known/farcaster.json
  • Authentication via Privy
  • Cast context and API access

Stripe Integration​

Purchase RSNC tokens to fund your program:

  1. Go to Funds → Add Funds
  2. Choose amount
  3. Complete Stripe checkout
  4. RSNC credited to your brand wallet

Supports both live (mainnet) and test (testnet) Stripe keys.

Settings​

Account​

  • Brand ID — Your wallet address
  • Brand name and profile
  • Contact information

Security​

  • Security Key — For HMAC authentication
  • Generate, rotate, and view key history
  • Used by bots, API integrations, and the Shopify app

Domains​

  • Add authorized domains for website integrations

Staging & Testnet​

The Partner Portal supports both mainnet and testnet environments:

  • Mainnet: partners.rsnc.network — Real RSNC tokens
  • Testnet: partners.resonance.xyz — Test tokens only

Data is isolated using a stage column in Supabase — mainnet and testnet data never mix. Both environments share the same Privy authentication but use separate contract addresses and API endpoints.

See the Testnet Guide for details.

Common Tasks​

Add RSNC to Your Brand​

  1. Go to Funds → Add Funds
  2. Choose payment method (Stripe)
  3. Complete purchase
  4. RSNC added to your brand wallet

Change Event Rewards​

  1. Go to Events
  2. Find your event
  3. Click to edit
  4. Update reward amount
  5. Save

Generate Security Key​

For developers using HMAC authentication:

  1. Go to Settings → Security
  2. Click Generate New Key
  3. Copy and store securely
  4. Use in your integration

Best Practices​

Event Configuration​

  • Start conservative — You can always increase rewards
  • Use cooldowns — Prevent gaming the system
  • Set limits — Control spending per event

Perk Strategy​

  • Mix prices — Have options at all RSNC levels
  • Limited supply — Creates urgency
  • Clear descriptions — Users should know what they get

Security​

  • Rotate keys — Generate new security keys periodically
  • Don't share — Keep security keys private
  • Monitor usage — Check analytics for anomalies
  • Use HMAC — Always validate webhook signatures

Support​

Last updated on