Integrations

Connect Resonance to your website, e-commerce platform, and social channels to reward users across every touchpoint.

Access integration settings from Dashboard → Integrations.

Website SDK

Embed the Resonance SDK on your website to automatically detect user actions and distribute RSNC.

Installation

Add the SDK script to your website's <head> tag:

<script src="https://reward.rsnc.network/resonance-sdk.js"></script>
<script>
  ResonanceAutomation.init('YOUR_BRAND_ID', {
    autoDetect: true,
    events: 'form_submit:25,newsletter_signup:50'
  });
</script>

Replace YOUR_BRAND_ID with your wallet address (found in Profile → Account Address, starts with 0x).

What the SDK Detects

With autoDetect: true, the SDK automatically detects:

• Form submissions (signup, contact, newsletter)
• Page visits matching URL patterns you configure
• Custom events you trigger via JavaScript

Custom Events

Trigger events manually in your code:

ResonanceAutomation.trackEvent('purchase_completed', {
  email: '[email protected]',
  value: 49.99
});

The event ID must match an event configured in your Reward → Events page.

REST API

Submit events programmatically from your backend.

Endpoint

POST https://reward.rsnc.network/resonance-api/manual-event

Example Request

curl -X POST https://reward.rsnc.network/resonance-api/manual-event \
  -H "Content-Type: application/json" \
  -H "X-Resonance-Brand-Id: 0xYOUR_BRAND_ID" \
  -H "X-Resonance-Signature: YOUR_HMAC_SIGNATURE" \
  -H "X-Resonance-Timestamp: 1700000000000" \
  -d '{
    "event_id": "purchase_completed",
    "user_email": "[email protected]",
    "metadata": { "order_value": 49.99 }
  }'

Authentication

The API uses HMAC-SHA256 signatures for authentication:

• X-Resonance-Brand-Id — Your wallet address (lowercase)
• X-Resonance-Signature — HMAC-SHA256 of BrandId | EventData | Timestamp using your Security Key
• X-Resonance-Timestamp — Current time in milliseconds (5-minute replay window)

Find your Security Key in Profile → Security Key.

Discord Bot

The Resonance Discord Bot rewards community engagement automatically. See the full Discord Bot Setup Guide for details.

Quick setup:

1. Go to Integrations → Discord in the Partner Portal
2. Click "Add Resonance Bot to Discord"
3. Select your server and authorize
4. Run /setup connect brand_id:0x... security_key:... in your server

Shopify

Connect your Shopify store to reward purchases and registrations automatically.

Setup

1. Go to Integrations → Shopify in the Partner Portal
2. Enter your Shopify store URL
3. Configure webhook events:
   • Order completed — Reward customers when they complete a purchase
   • Customer registration — Reward new account signups
4. Save your configuration

Shopify webhooks are processed by the Resonance event handler and matched to events you've configured in your Reward page.

Social Platforms

Connect social accounts to reward engagement across platforms.

Supported Platforms

Platform	Integration Type	What You Can Reward
Discord	Bot + OAuth	Messages, reactions, voice time, check-ins
Twitter/X	Bearer token	Likes, retweets, mentions, follows
Instagram	Meta app	Likes, comments, story views
Facebook	Meta app	Page engagement, event attendance
Telegram	Bot integration	Group activity, message engagement
Farcaster	FID + credentials	Casts, reactions, follows

Connecting Social Platforms

1. Go to Integrations in the Partner Portal
2. Select the platform you want to connect
3. Follow the OAuth flow or enter API credentials
4. Configure which actions trigger rewards
5. Map actions to events in your Reward page

Social platform credentials are encrypted at rest using AES-256-GCM and decrypted only at runtime.

Next Steps

• Redemption Integration — Accept perks on your website
• Analytics — Monitor integration performance