Onboarding

Step-by-step creator onboarding flow. Only Creator accounts exist currently; Buyer accounts are planned for future releases.

---

Overview

Creator onboarding is a multi-step process. Users can start from the app or web app.

---

Step 1: Email Entry

The user enters their email address only — same for app and web app.

API: POST /api/user/email/verify

{
  "email": "creator@example.com",
  "master_id": 42,        // optional, from invite deep link
  "fee_percentage": 5.5   // optional, from invite deep link
}

---

Step 2: Email Verification (Required)

• Mailgun sends a verification email
• User clicks button: "Yes, this is my email"
• System validates email confirmation
• User is redirected to app or web app (depending on Step 1)

---

Step 3: Currency Selection

• User selects preferred currency for payouts
• Permanent account setting — cannot be changed after creation
• Supported: USD, EUR, GBP (more addable via Admin panel)
• Default currency used if not explicitly selected

API: POST /api/register includes currency_id

---

Step 4: Account Information

User provides:

Field	Required	Notes
Referral code	No	5-digit code from another creator
First name	Yes
Last name	Yes
Birth date	Yes	Must be 18+
Address	Yes	Validated via Google Maps / Places API
Payout info	Yes	IBAN, BIC/SWIFT
Password	Yes	Created at this step

API: POST /api/register with full payload

---

Profile Verification (Before Upload)

Before uploading a product, account verification is required:

1. Veriff session is created via GET /api/veriff/create
2. Creator provides identity document to Veriff
3. Veriff confirms identity
4. Uploads are enabled

---

Optional: Affiliate Linking

New users can link to a referrer via:

• invite_code — 5-digit code during registration
• master_id + fee_percentage — from invite deep link (e.g. fangate.info/invite/abc12?master_id=42&fee_percentage=5)

---

Summary Flow

Email entry → Email verify → Currency select → Account info + password
     → Register (POST /api/register) → Veriff verify → Upload enabled