Frequently Asked Questions
50+ answers across 11 categories. Use Cmd/Ctrl+F to search the page or filter via the search box above.
General
What is Soryk?
Soryk is a Shopify-native sales rep app for B2B wholesalers. Native iOS + Android apps for field agents and customers, an embedded Shopify admin admin for the merchant, and a white-label buyer self-service customer app. Everything runs on Shopify's data — there's no separate database.
Who is Soryk for?
Shopify merchants with B2B sales motion: e-distributors, food wholesalers, chemical suppliers, wine importers, fashion B2B, anyone with a field sales team or repeat-order customers.
What's the elevator pitch?
SparkLayer + Pepperi-class B2B tooling, but native to Shopify, indie-priced, and shipped by people who answer their own emails.
Is Soryk built by Shopify?
No. We're independent (Italy-based) and build entirely on top of Shopify's public Admin API. Not affiliated with Shopify Inc.
What languages does Soryk support?
UI and customer-facing app: English, Italian, Spanish, French, German, Dutch, Polish, Portuguese.
Setup
Do I need Shopify Plus?
No. Since April 2026, Shopify B2B native features are available on all paid Shopify plans (Basic, Grow, Advanced, Plus). Soryk works on all of them — you just need B2B feature enabled in your Shopify settings. The only difference: non-Plus plans cap active catalogs at 3, while Plus has unlimited.
How long does setup take?
Self-service setup: 30–60 minutes if you have your data ready. With our Quick Setup service: about a week of async work, end-to-end. With Complete B2B Setup (you're not on B2B yet): 2–3 weeks.
What permissions does Soryk need on my Shopify store?
Read/write on products, orders, draft orders, customers, companies, metaobjects. Read on inventory and locations. See full scopes.
Will installing Soryk modify my existing data?
No, except for creating Soryk-specific metaobject definitions on first install (idempotent, reversible). Your products, customers, orders are untouched until an agent places an order through Soryk.
Can I uninstall safely?
Yes. Uninstalling revokes the access token. Your Shopify data stays untouched. Soryk metaobjects also remain in your store — re-install picks them up. Transient Upstash state is purged after 30 days.
Do I need a Resend account?
Optional. Default is the bundled noreply@soryk.app sender. For better deliverability and domain branding, plug in your own Resend API key.
Pricing
What are the tiers?
Direct €49 · Starter €79 · Growth €179 · Pro €399 · Scale €699. Direct is for solo merchants without agents. Starter and Growth fit most teams. Pro adds advanced commissions + manager hierarchy. Scale adds custom domain + self-host option.
Is there a setup fee?
Self-onboarding is free. Optional packages start at €499 (App Quick Setup) or €1,200 (Complete B2B Setup). Custom Migration is quote-only.
Do you charge per agent?
No per-agent fees. Each tier has a soft cap on active agents (e.g. Growth = 10, Pro = 30) but you can buy additional agent packs at €15/seat/mo if you exceed it.
Can I get a refund?
14-day money-back guarantee on the first month, no questions asked. After that, monthly subscriptions are pro-rated on cancellation.
Do you offer annual discounts?
Yes — 2 months free on annual upfront payment.
Multi-shop bundle?
Each store gets its own Soryk install (no shared databases). Volume discount: -20% from 3 shops, -30% from 5 shops, -40% from 10 shops. Includes a monthly call with the founder on the bundle plan.
Do I need Shopify Plus to use Soryk?
No. Since April 2026, Shopify B2B native features are available on all paid Shopify plans (Basic at $39/mo, Grow at $105/mo, Advanced at $299/mo, and Plus). Soryk works on all of them. For most B2B use cases, the cheapest paid plan is enough.
What's the difference between Basic and Plus for Soryk?
All Soryk features work identically on any paid Shopify plan. The differences come from Shopify B2B itself: non-Plus plans cap active catalogs at 3, while Plus has unlimited. Customer-specific pricing for 100+ unique buyers and partial payment workflows are also Plus-only. For most B2B operations, the catalog cap doesn't matter.
Mobile app
Is there a native iOS app?
Yes — on the App Store. Universal links open in the native app when installed.
Is there a native Android app?
Yes — on Google Play.
Can I just use the web version?
Yes. The agent app is also a app — install from any modern browser. Performance is identical, push notifications work too (with the iOS app caveat — see notifications docs).
Does the app work on tablets?
Yes. The layout adapts. Many field reps prefer iPads with offline catalogs for in-store demos.
Does the app work offline?
Catalog + pricing + drafts are cached. New orders queue and sync on reconnect. Useful in basements, warehouses, vineyards.
Is Soryk really a native iOS and Android app?
Yes. Native iOS app on Apple App Store, native Android app on Google Play. Real native binaries, not a wrapper around a website. Both apps include offline mode, push notifications, and native gestures.
Agents
How do agents log in?
Magic link via email (Resend) or Google SSO. Both options are always available — agents pick what they prefer.
Do agents need a Shopify account?
No. Only the merchant admin needs a paid Shopify plan with B2B. Agents have their own Soryk account, signed in with their email.
Can multiple agents work the same company?
Yes. Use the Fix Attribution flow when ambiguous orders come in. For structured splits, use the manager hierarchy + manager_override_percent.
How are territories defined?
Country, region, ZIP prefix, geo polygons, geo circles. Full guide.
Can I set up a manager → team agent hierarchy?
Yes. Pro tier and above. Managers see their team's pipeline, can place orders on their behalf, and earn an override % on top of the team's commissions.
How do I deactivate an agent without losing their history?
Set their Active toggle to off. Login is revoked, history preserved. Don't delete unless you're sure.
Commissions
How are commissions calculated?
You define rules per agent, collection, variant or globally — flat % with a configurable base (total / subtotal / no-shipping / no-tax-no-shipping). The engine matches the most specific rule per paid order. Full guide.
Can I have tiered or stepped commission rates?
Yes — by stacking rules with different scopes and priorities. Global 5% + collection-scoped 8% on Premium = a tiered model.
What happens on a refund?
If the rule has deductOnRefund: true and the commission was already paid, an alert fires. You resolve manually — either deduct in next payout, or ignore.
How do I record a payout?
From Commissions → Da pagare: multi-select rows, click Pay commissions, pick method, save. Idempotent — duplicate payments are rejected with HTTP 409.
Can I export commissions as CSV?
Yes. Three datasets: rules, due, paid. Use it for accounting or a payroll system handoff.
Are commissions calculated on online storefront orders too?
Off by default. Toggle commissionsOnOnlineOrders to include them — multi-agent fallback determines who earns.
Buyer portal
Is the customer app included in all tiers?
Available from Starter and up. White-label customization (logo + brand color) included; custom domain on Scale tier.
Can the customer app be hosted on my own domain?
Yes on Scale tier. Set a CNAME pointing to buyer.soryk.app and configure the portal at orders.yourbrand.com.
Can buyers see other companies' prices?
No. Strict server-side enforcement: every endpoint verifies the requested location belongs to the buyer's session companyId. Cross-tenant returns HTTP 403.
Can buyers self-register?
No. They must be a contact on a Shopify B2B Company you've already created. This prevents drive-by signups.
Data
Where is my data stored?
In Shopify (metaobjects + native objects). Transient state in Upstash Redis (EU). Nothing else.
Can I export my data?
Yes — directly from Shopify Admin. Soryk metaobjects are queryable via Admin GraphQL. Plus CSV export for commissions and analytics.
What happens to my data if I leave Soryk?
Your Shopify data stays in Shopify. Soryk metaobjects also remain (you can keep them, query them, or delete them). Upstash transient state purges after 30 days.
Can I delete specific data on request (GDPR)?
Yes — handled via Shopify's native customer-redact flows, which Soryk subscribes to. Soryk has nothing extra to delete on its side.
Security
Is Soryk GDPR-compliant?
Yes. EU data residency, DPA on request, processed only what Shopify stores.
Is there an audit log?
Yes — every privileged admin action. Mirrored to an append-only Upstash list (5,000-event window) for tampering detection. Details.
Do you support SSO?
Google + Microsoft OAuth via Shopify, standard at all tiers. We don't sell SAML or Okta as a separate enterprise add-on — sorry, we're not pretending.
Do you offer an SLA?
Best-effort 99.5% target. We monitor 24/7 but we don't sign contractual SLAs. Honest about it.
How do I rotate the JWT secret?
Documented 4-step zero-downtime procedure: issue new → set previous → wait one TTL → drop previous. Details.
Support
What's the response time?
One business day, async-first. Scale tier gets priority — typically same business day.
Do you offer phone support?
Not as a default. Italian Premium add-on (+€399/mo) includes scheduled calls in italiano + WhatsApp line.
What channels do you support?
Email, in-app chat, GitHub issues for technical bugs. No Slack Connect for individual customers (yet).
What languages does support speak?
English and Italian (native). Other languages async-translated, expect slight delay.
Migration
Can I migrate from SparkLayer?
Yes. We've done several. Custom Migration service, typically €2,000–€4,000, runs in parallel for 2 weeks before cutover.
Can I migrate from Pepperi?
Yes. Pepperi exports as CSV — we map to Shopify B2B + Soryk metaobjects. Quote-only because complexity varies wildly.
Can I migrate from Handshake (now Faire)?
Yes. We have a dedicated Handshake replacement guide.
Can I migrate from Excel / Access?
Yes — most painful but most common starting point. CSV per entity (companies, contacts, agents, price lists) → bulk import + manual review.
How long does a migration take?
1–4 weeks depending on data complexity, number of agents, and how clean the source data is. Capacity capped at 1–2 projects per month.
Didn't find your answer? Email dario@onlyfresh.com or use the in-app chat. We answer everything within one business day.