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
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
Stammdaten und Passwort
2 Min.Name des Weinguts, Anschrift, Passwort. Danach steht ein kostenloser Account im Cockpit bereit.
- 3
Cockpit erkunden
so lange Sie möchtenOhne Zeitdruck und ohne Kreditkarte umsehen. Shop-Funktionen sind sichtbar, aber noch gesperrt.
- 4
Tarif wählen
2 Min.Shop, Story oder Full Service — monatlich oder jährlich, auf Wunsch mit Done-for-you-Einrichtung.
- 5
Bezahlen
1 Min.Stripe Checkout für das Abo. Die Zahlung ist die Freigabe für alles Weitere.
- 6
Automatische Einrichtung
2 – 3 Min.Die Provisioning-Pipeline legt den Shop vollständig an. Den Fortschritt sehen Sie live im Cockpit.
- 7
Shop ist live
sofortErreichbar 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.
- Landingpage /register
- Self-Service-API
- Cockpit (kostenloser Account)
- Stripe Checkout
- Provisioning-Pipeline
- 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.
| Feld | Status | Wofür |
|---|---|---|
| Name des Weinguts | Pflicht | Erscheint im Cockpit, im Shop und auf Rechnungen |
| Ansprechpartner | Optional | Für Rückfragen |
| Straße und Hausnummer, PLZ, Ort | Pflicht | Anschrift für Impressum, Rechnungen und den Lagerort im Shop |
| Telefon | Optional | Für Rückfragen |
| Passwort | Pflicht | Mindestens 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:
| Tarif | Monatlich | Jährlich | Umfang |
|---|---|---|---|
| Shop | 39 € | 421,20 € | Onlineshop mit Weinbuch, Bestellungen, Rechnungen, Versand und Zahlungen |
| Story | 89 € | 961,20 € | Alles aus Shop, dazu Lagen, Rebsorten, Winzer-Portrait, Beiträge und Gutscheine |
| Full Service | 169 € | 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.
| # | Schritt | Was passiert |
|---|---|---|
| 1 | Medusa Admin Login | Die Pipeline meldet sich mit dem Plattform-Konto am Commerce-Backend an |
| 2 | Publishable API-Key | Der öffentliche Schlüssel, mit dem der Shop später seine Produkte abruft |
| 3 | Medusa Admin User | Der Cockpit-Zugang des Weinguts — mit dem Passwort aus der Registrierung |
| 4 | Medusa Sales-Channel | Die Mandantengrenze: eigener Kanal, mit dem Schlüssel verknüpft und Ende-zu-Ende geprüft |
| 5 | Lager & Versand | Lagerort mit der Anschrift des Weinguts und eine Versandoption „Standard DE“ |
| 6 | Cockpit-Stammdaten | Name, Anschrift, Tarif und Shop-Adresse landen im Cockpit-Profil |
| 7 | MinIO-Bucket | Eigener Medienspeicher — öffentlich lesbar, nicht öffentlich beschreibbar |
| 8 | Stripe-Connect-Konto | Das eigene Stripe-Konto des Weinguts, auf das später die Shop-Zahlungen gehen |
| 9 | Storefront-Container | Der Shop als eigener Container aus dem gemeinsamen Template |
| 10 | Traefik-Route | Die Adresse ihr-weingut.wein-online-verkaufen.de wird freigeschaltet, das Zertifikat kommt automatisch |
| 11 | Umami-Site (optional) | Cookiefreie Besucherstatistik; fehlt sie, läuft der Shop trotzdem |
| 12 | Go-live-E-Mail | Bestä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.
| Status | Bedeutung | Was das Weingut sieht |
|---|---|---|
| registered | E-Mail eingetragen, Anmeldelink verschickt | Das Cockpit führt direkt zum Stammdaten-Formular |
| onboarding | Stammdaten gespeichert — kostenloser Account | Cockpit offen, Shop-Funktionen gesperrt; nach der Zahlung läuft die Einrichtung |
| active | Einrichtung abgeschlossen, Shop live | Volles Cockpit nach einmaligem Neuanmelden |
| Sperre | Vom Betreiber im Master Dashboard gesetzt | Shop 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