Kapitel 3

Self-Service-Onboarding

Wie aus einer E-Mail-Adresse ein laufender Shop wird. Registrierung, Tarifwahl und Einrichtung laufen vollständig in Selbstbedienung — kein Termin, kein Skript, kein manueller DNS-Eintrag. Von der Zahlung bis zum fertigen Shop vergehen wenige Minuten.

Der Ablauf

Sieben Schritte, die ein Weingut selbst durchläuft. Nur die ersten fünf brauchen eine Eingabe; die Einrichtung danach erledigt die Plattform allein.

  1. 1

    Registrieren

    1 Min.

    Auf wein-online-verkaufen.de/register die E-Mail-Adresse eintragen. Mehr braucht es nicht — der Anmeldelink kommt per E-Mail.

  2. 2

    Stammdaten und Passwort

    2 Min.

    Name des Weinguts, Anschrift, Passwort. Danach steht ein kostenloser Account im Cockpit bereit.

  3. 3

    Cockpit erkunden

    so lange Sie möchten

    Ohne Zeitdruck und ohne Kreditkarte umsehen. Shop-Funktionen sind sichtbar, aber noch gesperrt.

  4. 4

    Tarif wählen

    2 Min.

    Shop, Story oder Full Service — monatlich oder jährlich, auf Wunsch mit Done-for-you-Einrichtung.

  5. 5

    Bezahlen

    1 Min.

    Stripe Checkout für das Abo. Die Zahlung ist die Freigabe für alles Weitere.

  6. 6

    Automatische Einrichtung

    2 – 3 Min.

    Die Provisioning-Pipeline legt den Shop vollständig an. Den Fortschritt sehen Sie live im Cockpit.

  7. 7

    Shop ist live

    sofort

    Erreichbar unter ihr-weingut.wein-online-verkaufen.de. Eine E-Mail bestätigt den Start und nennt die nächsten Schritte.

Von der Registrierung zum Shop

Welche Dienste beteiligt sind — die Details stehen in den Abschnitten unten.

  1. Landingpage /register
  2. Self-Service-API
  3. Cockpit (kostenloser Account)
  4. Stripe Checkout
  5. Provisioning-Pipeline
  6. Shop live

Schritt 1 — Registrierung

Auf der Landingpage führen „Kostenlos loslegen“, „Kostenlos registrieren“ und die Buttons unter den Tarifen zur Seite /register. Dort genügt die E-Mail-Adresse — keine Kreditkarte, kein Passwort, kein Formular.

  • Die Self-Service-API legt einen Account an und verschickt einen Anmeldelink (MagicLink)
  • Der Link führt direkt ins Cockpit unter cockpit.wein-online-verkaufen.de/onboarding
  • Er ist 15 Minuten gültig; danach einfach erneut registrieren — es kommt ein neuer Link

Schritt 2 — Stammdaten und Passwort

Der Anmeldelink öffnet im Cockpit das Formular „Willkommen!“. Mit Account erstellen ist der kostenlose Account fertig; ab dann meldet sich das Weingut mit E-Mail-Adresse und Passwort an.

Felder beim ersten Anmelden
FeldStatusWofür
Name des WeingutsPflichtErscheint im Cockpit, im Shop und auf Rechnungen
AnsprechpartnerOptionalFür Rückfragen
Straße und Hausnummer, PLZ, OrtPflichtAnschrift für Impressum, Rechnungen und den Lagerort im Shop
TelefonOptionalFür Rückfragen
PasswortPflichtMindestens acht Zeichen, zweimal eingegeben

Technisch wechselt der Account dabei vom Status registered zu onboarding. Was die Status bedeuten, steht unten im Abschnitt Status im Überblick.

Schritt 3 — Cockpit erkunden

Der kostenlose Account ist kein Demo-Modus, sondern das echte Cockpit — nur noch ohne Shop dahinter. Die Übersicht begrüßt mit „Dein Account ist bereit“ und zeigt die Tarife.

  • Offen: Übersicht, Einstellungen (unter anderem Profil), Hilfe und Feedback
  • Sichtbar, aber gesperrt: Bestellungen, Weinbuch, Kunden, Content, Einnahmen und Gutscheine — ein Klick erklärt, wie man sie freischaltet

Schritt 4 — Tarif wählen

„Jetzt Shop einrichten“ führt zur Seite /shop-einrichten im Cockpit. Sie hat drei Stufen: Paket, Zahlung, Einrichtung. In der ersten wird gewählt:

Tarife (zzgl. MwSt.)
TarifMonatlichJährlichUmfang
Shop39 €421,20 €Onlineshop mit Weinbuch, Bestellungen, Rechnungen, Versand und Zahlungen
Story89 €961,20 €Alles aus Shop, dazu Lagen, Rebsorten, Winzer-Portrait, Beiträge und Gutscheine
Full Service169 €1.825,20 €Alles aus Story, dazu individuelles Design, Domain-Management und Account-Manager
  • Abrechnung: monatlich und monatlich kündbar, oder jährlich mit 10 % Rabatt
  • Done for you (optional, 500 € einmalig): Wir legen die Weine an, richten Versand, Zahlungen und Rechtstexte ein und schalten den Shop live
  • Wunsch-Adresse (optional): der vordere Teil von ihr-weingut.wein-online-verkaufen.de

Schritt 5 — Bezahlen mit Stripe

Die Stufe „Zahlung“ zeigt die Zusammenfassung und den heute fälligen Betrag. Zahlungspflichtig bestellen leitet zu Stripe Checkout weiter; dort wird das Abo abgeschlossen, auf Wunsch zusammen mit der Done-for-you-Einrichtung. Danach geht es automatisch zurück ins Cockpit.

  • Die Einrichtung startet erst nach bestätigter Zahlung — über die Rückkehr aus Stripe oder den Stripe-Webhook, je nachdem, was zuerst ankommt
  • Ein Abbruch im Checkout ist folgenlos: Das Cockpit meldet ihn, der kostenlose Account bleibt bestehen
  • Eine Buchungsbestätigung kommt zusätzlich per E-Mail

Schritt 6 — Automatische Einrichtung

Nach der Zahlung startet die Provisioning-Pipeline der Self-Service-API. Sie arbeitet zwölf Schritte der Reihe nach ab und prüft jeden einzeln, bevor sie weitergeht. Das Cockpit zeigt den Fortschritt live — mit Fortschrittsbalken und einer Liste, in der sich die Häkchen nacheinander füllen.

Die Schritte der Provisioning-Pipeline
#SchrittWas passiert
1Medusa Admin LoginDie Pipeline meldet sich mit dem Plattform-Konto am Commerce-Backend an
2Publishable API-KeyDer öffentliche Schlüssel, mit dem der Shop später seine Produkte abruft
3Medusa Admin UserDer Cockpit-Zugang des Weinguts — mit dem Passwort aus der Registrierung
4Medusa Sales-ChannelDie Mandantengrenze: eigener Kanal, mit dem Schlüssel verknüpft und Ende-zu-Ende geprüft
5Lager & VersandLagerort mit der Anschrift des Weinguts und eine Versandoption „Standard DE“
6Cockpit-StammdatenName, Anschrift, Tarif und Shop-Adresse landen im Cockpit-Profil
7MinIO-BucketEigener Medienspeicher — öffentlich lesbar, nicht öffentlich beschreibbar
8Stripe-Connect-KontoDas eigene Stripe-Konto des Weinguts, auf das später die Shop-Zahlungen gehen
9Storefront-ContainerDer Shop als eigener Container aus dem gemeinsamen Template
10Traefik-RouteDie Adresse ihr-weingut.wein-online-verkaufen.de wird freigeschaltet, das Zertifikat kommt automatisch
11Umami-Site (optional)Cookiefreie Besucherstatistik; fehlt sie, läuft der Shop trotzdem
12Go-live-E-MailBestätigung mit Shop-Adresse, Cockpit-Link und den nächsten Schritten (optional)

Was hier nicht mehr vorkommt: Sales Channel per Skript anlegen, DNS-Einträge setzen, Branding von Hand. Für die Shop-Adressen unter wein-online-verkaufen.de gibt es einen Wildcard-DNS-Eintrag; die Route schreibt die Pipeline selbst, das Zertifikat holt Traefik beim ersten Aufruf. Logo und Anschrift pflegt das Weingut selbst im Cockpit.

Schritt 7 — Shop ist live

Nach dem letzten Schritt steht der Account auf active, und der Shop ist unter https://ihr-weingut.wein-online-verkaufen.de erreichbar — zunächst noch ohne Weine. Die Go-live-E-Mail fasst Shop-Adresse, Cockpit-Link und Tarif zusammen.

Danach, in dieser Reihenfolge:

  • Unter Einstellungen → Zahlungen auf „Stripe-Konto verbinden“ klicken und das Stripe-Onboarding abschließen
  • Versandkosten unter Einstellungen → Versand prüfen — angelegt ist eine Pauschale für Deutschland
  • Rechtstexte unter Einstellungen → Rechtliches hinterlegen: Impressum, Datenschutz, Widerruf, AGB
  • Logo und Anschrift unter Einstellungen → Profil prüfen — sie stehen auf jeder Rechnung
  • Die ersten Weine im Weinbuch anlegen, mit Bild und Verkostungsnotiz
  • Eine Testbestellung im eigenen Shop durchspielen

Wie die einzelnen Masken aussehen, zeigt der Quick-Start-Guide.

Status im Überblick

Jeder Account trägt in der Self-Service-API einen Status. Cockpit und Master Dashboard richten sich danach.

Account-Status
StatusBedeutungWas das Weingut sieht
registeredE-Mail eingetragen, Anmeldelink verschicktDas Cockpit führt direkt zum Stammdaten-Formular
onboardingStammdaten gespeichert — kostenloser AccountCockpit offen, Shop-Funktionen gesperrt; nach der Zahlung läuft die Einrichtung
activeEinrichtung abgeschlossen, Shop liveVolles Cockpit nach einmaligem Neuanmelden
SperreVom Betreiber im Master Dashboard gesetztShop und Cockpit zeigen nur noch einen Hinweis, Impressum und Datenschutz bleiben erreichbar

Kündigt ein Weingut sein Abo oder schlägt eine Abbuchung fehl, vermerkt die Self-Service-API das über den Stripe-Webhook als cancelled beziehungsweise suspended. Gesperrt wird ein Shop aber nur über die Sperre im Master Dashboard — das bleibt eine bewusste Entscheidung des Betreibers.

Was der Betreiber noch tut

Im Normalfall nichts — der Betreiber sieht neue Accounts im Master Dashboard unter admin.wein-online-verkaufen.de: Interessenten und frisch Registrierte unter „Prospects“, Weingüter mit Stammdaten — vom kostenlosen Account bis zum laufenden Shop — unter „Kunden“, Rückmeldungen unter „Feedback“. Hand anlegen muss er in diesen Fällen:

  • Einrichtung fehlgeschlagen — Ursache aus dem angezeigten Schritt beheben, dann den Lauf erneut anstoßen
  • Done for you — Weine, Versand, Zahlungen und Rechtstexte im Auftrag des Weinguts einrichten
  • Eigene Domain — die Verbindung einer eigenen Domain richtet derzeit der Betreiber ein; eine Selbstbedienung im Cockpit ist in Arbeit
  • Sperren und Reaktivieren — im Master Dashboard, zum Beispiel bei offenen Zahlungen