Produktkatalog¶

Ein Produkt ist das wiederverwendbare Element hinter allem, was Sie verkaufen: ein SaaS-Plan, ein physisches Produkt, eine Dienstleistung oder ein einmaliges Angebot. Definieren Sie es einmal und verknüpfen Sie es mit Zahlungslinks, Abonnementplänen oder Checkout-Sitzungen, statt dieselben Daten bei jeder Zahlung zu wiederholen.

Auf einen Blick

Für wen: Teams, die ein oder mehrere Produkte oder Dienstleistungen verkaufen.
Zeit: 5 Minuten.
Ergebnis: ein wiederverwendbares Produkt für Pläne und Zahlungslinks.

Für wen
Founder, Operations und Entwicklung

Zeit
5 Minuten

Niveau
Einsteiger

Ergebnis
Wiederverwendbarer Katalog

Was ist ein Produkt?¶

Ein Produkt speichert Name, Beschreibung und Status dessen, was Sie verkaufen. Pläne und Zahlungslinks verweisen auf das Produkt, statt seine Informationen zu duplizieren.

Eine Quelle der Wahrheit — aktualisieren Sie das Produkt einmal und verwenden Sie es überall.
Klarere Berichte — gruppieren Sie Umsatz nach Produkt statt nach einzelner Zahlung.
Schnellere Einrichtung — erstellen Sie einen Plan oder Link, ohne das Angebot neu zu erfassen.

Verfügbarkeit in der Konsole

Der Katalog ist heute über die API verfügbar. Die Ansicht in der Konsole wird pro Workspace ausgerollt. Wenn Sie Payments → Products noch nicht sehen, nutzen Sie die API oder wenden Sie sich an den Support.

Ein Produkt erstellen¶

APIKonsole

curl -X POST 'https://api.4geeks.io/v1/products' \
  -H 'X-Api-Key: sk_test_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Premium-Plan",
    "description": "Monatliches Abonnement mit allen Funktionen",
    "active": true
  }'

Die Antwort enthält die Produkt-id, die Sie beim Erstellen eines Plans oder Zahlungslinks verwenden können.

Öffnen Sie die 4Geeks Console.
Gehen Sie zu Payments → Products.
Wählen Sie New product.
Geben Sie einen Namen und eine optionale Beschreibung ein.
Speichern Sie das Produkt und kopieren Sie die ID.

Produktfelder¶

Feld	Typ	Erforderlich	Hinweise
`name`	string	Ja	Für Kunden sichtbarer Produktname
`description`	string	Nein	Kurze Erklärung, was der Kunde erhält
`active`	boolean	Nein	Standard `true`; inaktive Produkte können nicht verkauft werden

Produkte, Pläne und Zahlungslinks¶

Sie brauchen…	Verwenden Sie…	Warum
Eine einmalige Zahlung mit wiederverwendbarer Beschreibung	Produkt + Zahlungslink	Teilen Sie eine URL, ohne das Angebot neu zu erstellen
Ein wiederkehrendes Abonnement	Produkt + Plan	Der Plan ergänzt Betrag, Währung und Intervall
Einen vollständig individuellen Checkout	Produkt + Checkout-Sitzung	Sie steuern die Erfahrung in Ihrer App

Katalog verwalten¶

Produkte auflisten mit GET /v1/products und paginieren mit limit und offset.
Deaktivieren Sie ein Produkt, statt es zu löschen, um die Historie zu erhalten.
Halten Sie Namen stabil — sie erscheinen in Checkout, Belegen und Berichten.

Häufige Fragen¶

Kann ich ein Produkt nach dem Erstellen eines Plans ändern?

Ja. Name und Beschreibung können aktualisiert werden. Der Preis liegt im Plan, daher erfordert eine Betragsänderung kein neues Produkt.

Benötigen Zahlungslinks ein Produkt?

Nein. Zahlungslinks können nur mit Beschreibung und Betrag erstellt werden. Produkte empfiehlt sich, wenn Sie einen wiederverwendbaren Katalog und konsistente Berichte möchten.

Was passiert, wenn ich ein Produkt deaktiviere?

Bestehende Pläne und Links behalten ihre Historie, aber neue Checkouts sollten ein aktives Produkt verwenden.