intermediate
juicer
onboarding
KYC

Juicer-Onboarding

Wie Juicer sich anmelden, Stripe Identity KYC abschließen, Stripe Connect Express-Auszahlungen einrichten und die Bundesstaat-Allowlist-Prüfung bestehen

Levy Fleets TeamMay 18, 20267 min read

Juicer-Onboarding

Ein Juicer kann keine einzige Prämie beanspruchen, bevor KYC bestanden, ein Auszahlungskonto eingerichtet und die Sicherheits-Bestätigung unterzeichnet wurde. Der Ablauf ist auf unter 10 Minuten von "Bewerben antippen" bis "erste beanspruchbare Prämie" ausgelegt.

Was ein Juicer vorab braucht

  • Ein Smartphone (iOS 16+ oder Android 12+) mit installierter Juicer-App
  • Einen amtlichen Lichtbildausweis (Führerschein, Pass oder staatliche ID)
  • Die letzten 4 Ziffern der US-Sozialversicherungsnummer (SSN)
  • Ein US-Bankkonto mit ACH-Unterstützung
  • Eine Wohnadresse in einem erlaubten Bundesstaat (siehe unten)

Schritt 1: Bewerbung

Der Juicer lädt die Juicer-App (heute als rollen-gegateter Modus innerhalb der operator-app; eine role === 'juicer'-Mitgliedschaftszeile gibt die UI frei), öffnet sie und tippt Als Juicer bewerben.

Eingaben:

  • Rechtsname (muss mit der ID übereinstimmen)
  • Telefonnummer
  • E-Mail
  • Heimatadresse – wird als home_geo PostGIS-Punkt gespeichert und für den späteren Claim-Radius genutzt

Die App ruft POST /api/juicer/onboarding auf, das:

  1. Eine juicers-Zeile mit ihrer auth.users.id upsertet
  2. Eine Stripe-Identity-Verifizierungssession erstellt
  3. Ein Stripe-Connect-Express-Konto erstellt
  4. Zwei URLs zurückgibt: Identity-Onboarding und Connect-Onboarding

Schritt 2: Bundesstaat-Allowlist-Prüfung

Die Heimatadresse wird mit der Bundesstaat-Allowlist abgeglichen. Standard:

  • TX (Texas)
  • FL (Florida)
  • GA (Georgia)
  • NC (North Carolina)
  • AZ (Arizona)

Diese Staaten haben operativ verteidigbare Gig-Worker-Regeln – klare 1099-Vertragsklassifikation, keine spezifischen Mindeststundenlöhne für Gig-Worker und keine neuere Gesetzgebung (wie AB5 in CA), die Auftragnehmer als Angestellte umklassifiziert.

Liegt die Adresse außerhalb, sieht der Juicer "In Ihrem Bundesstaat noch nicht verfügbar", und die juicers-Zeile bleibt in pending, bis:

  • Der Juicer auf eine Adresse innerhalb der Allowlist umzieht
  • Levy die Allowlist erweitert (nur nach rechtlicher Prüfung)

Die Allowlist ist pro Bundesstaat, nicht pro Stadt, und auf der Plattform konfigurierbar – Betreiber sollten sie nicht ohne Rechtsprüfung umlegen.

Schritt 3: Stripe Identity KYC

Der Juicer öffnet die Stripe-Identity-URL. Stripe führt durch:

  • Hochladen des amtlichen Ausweises (Vorder- und Rückseite)
  • Selfie-Liveness
  • Eingabe der SSN-letzten-4
  • Adressprüfung

Stripe prüft serverseitig. Die meisten Verifizierungen kehren in Minuten zurück; bis zu 24 Stunden, falls manuelle Prüfung greift.

Die Levy-Plattform lauscht auf identity.verification_session.verified-Webhooks. Sobald sie eintreffen, setzt sie:

  • juicers.kyc_status = 'verified'
  • juicers.status = 'active' (sofern auch Connect Express fertig)
  • juicers.stripe_identity_session_id auf die Session

Schlägt die Verifizierung fehl (requires_input oder canceled), sieht der Juicer eine "Verifizierung abschließen"-Aufforderung mit Wiederholungslink.

Warum Stripe Identity

Stripe Identity kostet rund 1,50 USD pro Prüfung, unterstützt US-IDs in allen Start-Staaten und integriert sauber mit Stripe Connect. Wir speichern das ID-Bild nicht – Stripe tut es – was unsere Haftungsfläche klein hält.

Schritt 4: Stripe Connect Express

Parallel schließt der Juicer das Connect-Express-Onboarding ab:

  • Bankkonto eingeben (Routing + Kontonummer oder Instant-Verifikation über Plaid)
  • Bestätigt, dass der Rechtsname zur Identity-Prüfung passt
  • Stimmt Stripes Connect-Servicevertrag zu

Wenn account.updated von Stripe mit payouts_enabled: true eintrifft, setzt die Plattform juicers.stripe_account_payouts_enabled = true. Sowohl kyc_status = 'verified' als auch payouts_enabled = true müssen wahr sein, bevor der Juicer eine Prämie beanspruchen kann.

Connect Express erledigt die 1099-Erstellung am Jahresende – Stripe stellt das 1099-NEC aus und mailt es dem Juicer.

Schritt 5: Sicherheits-Bestätigung

Vor dem ersten Claim signiert der Juicer eine einseitige Bestätigung zu:

  • Keine beschädigten Packs laden (sichtbare Aufblähung, Lecks, Rauch, heiß)
  • Pack nicht öffnen oder Stecker modifizieren
  • Nur mitgeliefertes Ladegerät verwenden – kein Fremdfabrikat-Schnelllader
  • In gut belüftetem Bereich laden
  • Lithium-Ionen-tauglicher Feuerlöscher in der Nähe (Betreiber können ein 25-USD-Starter-Kit anbieten)

Das ist Bestandteil der Levy-Versicherungsklausel (Christensen Group). Die signierte PDF liegt im Profil und erscheint in Garantie-/Vorfall-Audits.

Schritt 6: Betreiberprüfung (optional)

Manche Betreiber fordern eine menschliche Prüfung vor Aktivierung – ein kurzer Blick, manchmal ein 10-minütiges Telefonat. Die "Ausstehende Aktivierung"-Liste unter Dashboard → Juicer erlaubt Genehmigen, Ablehnen oder Halten.

Wenn require_juicer_review = true im Unterkonto gesetzt ist, aktiviert die Plattform den Juicer nicht automatisch, wenn Identity + Connect bestanden sind – sie wartet auf die Genehmigungsaktion.

Aktivierung

Sobald all dies erfüllt ist, ist der Juicer active:

  • kyc_status = 'verified'
  • stripe_account_payouts_enabled = true
  • Adresse innerhalb der Bundesstaat-Allowlist
  • Sicherheits-Bestätigung signiert
  • Betreiberprüfung bestanden (falls erforderlich)

Die Juicer-App lädt neu, die Prämienkarte füllt sich, und der erste Claim ist möglich.

Sperren und Bannen

Betreiber können einen Juicer jederzeit aus dem Dashboard suspendieren oder bannen:

  • Suspendierenjuicers.status = 'suspended'. Stornieren laufende Claims und halten eingereihte Auszahlungen.
  • Bannenjuicers.status = 'banned'. Gleicher Effekt, endgültig.

Der Auslöser ist oft ein Fraud-Score-Schwellenwert – siehe Juicer-Betrugserkennung – oder ein einzelner Vorfall.

Häufige Onboarding-Probleme

  • "Verifizierung fehlgeschlagen" – meist unscharfer oder abgelaufener Ausweis. Wiederholung möglich.
  • "Bundesstaat noch nicht verfügbar" – Adresse nicht in der Allowlist.
  • "Auszahlungen nicht aktiviert" – Stripe Connect Express wartet auf Bankprüfung. Häufig innerhalb einer Stunde gelöst.
  • Erste Prämie erscheint nicht – Betreiberprüfung erforderlich, oder keine offenen Prämien im Claim-Radius.