Shopify App
Turn every purchase into a loyalty reward.
The Resonance Shopify App is an embedded Shopify application that lets merchants add loyalty rewards to their store. Customers earn RSNC credits on purchases and can redeem perks — all managed through a native Shopify admin interface.
App URL: rsnc-shopify-app.rsnc.network
What Merchants Get
- Earning Rules — Configure credits per dollar, minimum order amounts, product filters, and time windows
- Automatic Rewards — Orders trigger credit distribution via webhooks
- Customer Sync — Shopify customers are automatically mapped to Resonance accounts
- Analytics Dashboard — Track credits issued, orders processed, and customer engagement
- Storefront Widget — Embed a loyalty widget on your store via App Proxy
- Perk Management — Browse and manage perks from the Resonance network
- Discount Bridge — Perk redemptions generate Shopify discount codes automatically
- Funding — Top up your brand balance via Stripe directly from the app
Tech Stack
| Component | Technology |
|---|---|
| Framework | Remix (React SSR) |
| Hosting | Cloudflare Workers |
| Database | Cloudflare D1 (SQLite) |
| UI | Shopify Polaris |
| Auth | Shopify OAuth |
| Payments | Stripe (for RSNC funding) |
How It Works
Customer places order on Shopify store
↓
Shopify fires orders/create webhook
↓
App matches earning rules (credits per dollar, product filters, etc.)
↓
Streak multiplier applied (if customer has active streak)
↓
Credits submitted to Resonance API
↓
Customer earns RSNC credits
OAuth Scopes
| Scope | Purpose |
|---|---|
read_orders | Read order data for reward calculation |
read_customers | Read customer info for identity mapping |
write_discounts | Create discount codes for perk redemptions |
read_products | Read product info for product-specific rules |
Webhook Topics
| Topic | Purpose |
|---|---|
orders/create | Process orders and distribute rewards |
customers/create | Register new customers |
app/uninstalled | Clean up on app removal |
customers/data_request | GDPR data export |
customers/redact | GDPR customer deletion |
shop/redact | GDPR shop data deletion |
Storefront Widget
The app includes a storefront widget served via Shopify App Proxy at /apps/resonance/*. Customers can:
- View their credit balance
- Check daily streak status and check in
- Browse available perks
- Redeem perks (generates Shopify discount codes)
- See current earning rates
Pages
| Page | Description |
|---|---|
| Dashboard | Overview of active rules, customers, credits issued, and balance |
| Earning Rules | Create and manage earning rules |
| Analytics | Performance metrics over 7/30/90 day periods |
| Customers | View and search customer mappings |
| Perks | Browse available perks from the network |
| Settings | Brand configuration, security key, embed scripts |
| Onboarding | 4-step setup wizard for new merchants |
Next Steps
- Setup Guide — Install and configure the app
- Earning Rules — Configure how customers earn rewards
- Troubleshooting — Common issues and solutions