FAQ
Answers before launch
Campaign, integration, and operations answers for teams evaluating Sorae.
Platform
Is Sorae only for Shopify stores?
No. Shopify is fully supported with embedded admin, theme widgets, and webhook-driven order processing. Sorae also supports a workspace-driven API-first model for SaaS platforms, headless storefronts, and non-Shopify DTC brands, using the same campaign engine and JS SDK.
Can I run referral, affiliate, creator, and giveaway campaigns together?
Yes. All four campaign types run from one platform with shared analytics, a shared reward engine, and one admin surface. You can run programs in parallel, a referral loop alongside an affiliate program, a creator partnership campaign, and a seasonal giveaway, with each scoped to its own policy rules.
Does Sorae include affiliate applications and payouts?
Yes. Affiliates apply through a public intake form, merchants approve from admin, and Sorae auto-activates share links for approved partners. Commission rows accrue per conversion period and batch-execute through Stripe Connect with item-level payout status tracking.
What anti-abuse controls does Sorae include?
Self-referral blocking, new-customer enforcement, minimum subtotal checks, IP address tracking, and user-agent capture all run as part of the conversion pipeline, before any reward issues. Structured suppression records log every blocked conversion with a reason code for operator visibility. Manual review and revocation paths are also available for edge cases.
Does Sorae support multiple active campaigns at once?
Yes. Multiple campaigns can run simultaneously per tenant, each with its own reward policy, attribution rules, and lifecycle status. Analytics are filterable by campaign and date range so you can compare performance across programs.
How does Sorae handle reward clawbacks when orders are cancelled?
Configurable delay windows hold reward issuance for a set period after conversion. If an order is cancelled during that window, Sorae reverses the conversion before the reward issues. For rewards already issued, manual revocation is available with a required reason entry and audit trail.
Does Sorae have an AI feature?
Yes. Sorae's AI Assist layer generates campaign-aware share copy variants for advocates, personalized to your campaign context so the copy actually converts. It also flags underperforming campaigns with operator-ready insights and suggested next steps, surfaced directly in the analytics dashboard.
Creator Partnerships
How does escrow work for creator campaigns?
When a brand accepts a creator's proposal, the agreed amount is charged to the brand and held in escrow. The creator can see that funds are secured before starting work. Once the brand reviews and accepts the submitted deliverable, escrowed funds are released to the creator automatically. If a deliverable is rejected after all revision rounds are exhausted, funds are refunded to the brand. No invoicing, no payment disputes.
Can creators work with multiple brands?
Yes. Creators sign up once and manage all brand relationships from a single dashboard. One Stripe Connect account handles payouts across every brand they work with. There are no duplicate registrations or separate logins per brand. Creators build a portable profile and work history that follows them across the platform.
What types of deliverables are supported?
Creator campaigns support both monetary and non-monetary deliverables. Monetary deliverables include paid work like UGC videos, social media posts, blog features, and product reviews, each with defined budgets and escrow-backed payment. Product gifting is also supported as a deliverable type for collaborations where the brand sends product in exchange for content, without a cash payment component.
Developers
Is there a JavaScript SDK?
Yes. The Sorae JS SDK supports widget-first and headless implementation paths. Prebuilt widgets handle advocate start, friend claim, and affiliate portal experiences. Headless SDK methods wrap the same public API endpoints with TypeScript types for teams building custom storefront UIs.
Can we build custom frontend experiences?
Yes. The JS SDK's headless methods let you drive every advocate, referral, and affiliate interaction through your own UI, without rendering any Sorae-hosted widget surfaces. API response contracts are normalized across endpoints so integration is consistent.
Do you provide API and webhook support?
Yes. Sorae's public REST APIs support referral, affiliate, attribution, and analytics workflows. Webhook delivery covers conversion and reward lifecycle events. Service-to-service integrations can use API key authentication with optional HMAC request signing for verified request contexts.
How does the JS SDK handle Shopify theme compatibility?
Widget renderers are designed for Shopify Online Store 2.0 theme placement via the Theme Editor. No theme liquid editing required. The SDK also includes app proxy short-link resolution so referral attribution context is captured before the friend's browser loads any storefront page.
Does Sorae support HMAC request signing?
Yes. HMAC secrets are managed through workspace or Shopify admin settings. Server-side integration patterns can sign requests with the HMAC secret for verified request contexts. This is particularly useful for webhook verification and server-to-server API calls.
Are there webhook events we can subscribe to?
Yes. Sorae emits events for key lifecycle moments: advocate start, invite sent, referred visit, conversion finalized, reward issued, and commission accrued. For Shopify merchants, outbound events also sync to Klaviyo if the integration is connected, so your lifecycle flows trigger at the right moments.
Operations
How long does setup take on Shopify?
Most stores complete setup in one working session. The setup checklist in the embedded admin walks through publishing campaign pages, placing widgets in the Theme Editor, enabling the tracking embed, and validating attribution events. The checklist shows live state for each step so you know what's complete before launch.
Can affiliate partners view their own performance?
Yes. Affiliates access their own portal showing conversion history, commission accrual by period, and payout status. The affiliate portal is available as a prebuilt widget via the JS SDK or accessible through headless API methods for teams building custom partner dashboards.
How are affiliate commissions calculated?
Commission rows are created per conversion event and linked to the specific affiliate and conversion order. Commission amounts are calculated based on campaign-level commission rules and grouped by period. Rows are finalized before payout batch creation, protecting accounting integrity from late order cancellations or reversals.
Can I run a giveaway without also running a referral program?
Yes. Each campaign type runs independently. You can launch a giveaway for list growth without activating a referral or affiliate program. Campaign types share the platform infrastructure but operate with separate configuration, analytics, and lifecycle controls.
Can we migrate from another referral tool?
Yes. Sorae can be deployed incrementally, starting with a new campaign while your existing tool winds down, or running both in parallel during a transition period. The Shopify integration installs without removing your current app, so you can validate attribution events before fully switching over.
What does the analytics export include?
CSV exports cover advocates with conversion and reward history, affiliates with commission and payout records, conversions with attribution channel and order data, rewards with issuance status and timing, and commission data with period and finalization state. No manual joins required. Each export is ready for finance reports, CRM imports, or growth dashboards.