Last verified: 2026-05-30

New merchant onboarding

First-time setup flow before full access to /admin. You are launching a direct ordering web app (storefront) for guests — not replacing third-party marketplace apps on day one. See Merchant channel terminology.

Routes (marketing / auth shell)

Steps — paid signup

1. Create account at /register or sign in at /login.
2. Complete email verification at /verify-email when prompted (check spam folder).
3. Open /onboarding — the wizard collects business name, type, region, and plan (planId, billingTerm, regionId may be pre-filled from marketing links).
4. When checkout is required, continue to /payment and complete PSP payment.
5. After success, land on /onboarding/success, then /admin.
6. Complete Set up organization (legal entity + first branch/property).
7. Connect payouts under Payout settings and review Subscription and plan limits.

Freemium path

Some tenants start via /freemium or platform-created freemium orgs (superadmin). Conversion to paid may use superadmin Convert workflow — see platform docs.

Verify it worked

• /admin loads without redirect to onboarding.
• Organization appears under Organization / Branches management.

Related articles

• Set up organization
• Commission billing (if applicable to plan)