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, organized into five tabs:

TabWhat It Shows
OverviewHealth score, RSNC distribution trends, user acquisition sources, platform breakdown
GrowthNew vs. returning users, top acquisition channels, weekly cohort analysis
RetentionDAU/MAU ratio, engagement trends, churn rate tracking
BudgetRSNC distributed vs. purchased, cost efficiency, daily spend trends
Perks & RafflePer-perk claim counts, inventory alerts, raffle pool, recent draws

Data updates in real time — no page reload needed. Export reports as PDF or CSV from the download menu.

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

Raffle​

Run weekly raffles for your community. Configure in Perks → Raffle:

  • Prize types — RSNC, Perk NFT, Crypto token, NFT, NFT Pool (random from a set), or Off-chain (manual fulfillment)
  • Consumes ticket — Toggle whether winners keep or lose their entry perk
  • Manual draws — Trigger a draw on demand with the "Draw now" button
  • Auto draws — Scheduled weekly draws (configured by the system)
  • Draw history — View past winners, payout status, and prize details

Users earn raffle entries automatically when they claim perks tagged with the raffle-entry reward type.

Analytics​

The Stats dashboard provides five analysis views (see Dashboard above). Key capabilities:

  • Real-time updates — Data refreshes automatically as events arrive
  • PDF & CSV export — Download reports for offline review
  • Health scoring — Composite score based on growth, retention, and engagement
  • Inventory alerts — Automatic warnings when perk supply runs low
  • Churn tracking — Identify at-risk users before they leave

Integrations​

Discord​

  • Add bot to your server
  • Role sync — Automatically assign Discord roles based on RSNC holdings
  • Signal Subscriber role — Auto-granted to active Signal subscribers, revoked on lapse
  • Notification channel — Set via /config notification-channel in Discord; syncs here automatically
  • 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