Erste Schritte mit Proyecta Commerce

Integrierte Zahlungen für jede Proyecta-App. Verbinde Stripe über Dashboard > Commerce und verkaufe Abonnements, Einmalprodukte oder alles dazwischen.

Achtung

Commerce-APIs befinden sich derzeit in der Beta-Phase. Die wichtigsten Abläufe (Stripe Connect Onboarding, Produkte, Kunden, Checkout, Transaktionen, Steuern) sind live, aber einige Funktionen wie der Testmodus und die Einstellungen für den Kontoauszugs-Descriptor werden noch entwickelt.

Proyecta Commerce gibt jeder App ein vollwertiges Zahlungssystem, ohne den Builder zu verlassen. Öffne Dashboard > Commerce — es gibt sechs übergeordnete Tabs:

Tab	Wofür er gedacht ist
Products	Definiere, was du verkaufst (Abonnements, Einmalig, Kostenlos) — enthält Features und Coupons als Unter-Tabs
Customers	Die zahlungspflichtigen Nutzer deiner App
Subscriptions	Aktive wiederkehrende Abonnements verwalten
Payments	Erfolgreiche Abbuchungen, Rückerstattungen und Streitigkeiten
Payouts	Umsatzauszahlungen und Auszahlungsverfolgung
Settings	Dein Stripe-Konto verbinden (Payment Entity)

Schritt 1: Stripe verbinden

Commerce verwendet intern Stripe Connect — du benötigst kein bestehendes Stripe-Konto, aber du durchläufst einmalig den Onboarding-Prozess von Stripe.

1. Öffne Dashboard > Commerce und wechsle zum Tab Settings
2. Klicke auf Connect Stripe
3. Wähle dein Country aus dem Dropdown
4. Klicke auf Create Account
5. Klicke auf Complete Setup, um das eingebettete Stripe-Onboarding im Panel zu öffnen
6. Gib Unternehmensdaten, Bankdaten und Verifizierungsdokumente ein
7. Nach deiner Rückkehr wechselt der Status deiner Payment Entity von onboarding → active

Unterstützte Länder

Proyecta Commerce verwendet Stripe Connect. Jedes Land, das von Stripe Connect unterstützt wird, kann genutzt werden — eine vollständige und aktuelle Liste findest du unter Stripes Liste unterstützter Länder.

Falls du beim Onboarding aus deinem Land auf Probleme stößt, kontaktiere den Support.

Weltweite Verfügbarkeit

Stripe wird derzeit in den folgenden Ländern/Regionen unterstützt, weitere folgen. Sobald Stripe in deinem Land/deiner Region verfügbar ist, kannst du Kunden weltweit beliefern.

🇦🇺 Australien 🇦🇹 Österreich 🇧🇪 Belgien 🇧🇷 Brasilien 🇧🇬 Bulgarien 🇨🇦 Kanada 🇨🇮 Côte d'Ivoire Erweitertes Netzwerk 🇭🇷 Kroatien 🇨🇾 Zypern 🇨🇿 Tschechische Republik 🇩🇰 Dänemark 🇪🇪 Estland 🇫🇮 Finnland 🇫🇷 Frankreich 🇩🇪 Deutschland 🇬🇭 Ghana Erweitertes Netzwerk 🇬🇮 Gibraltar 🇬🇷 Griechenland 🇭🇰 Hongkong 🇭🇺 Ungarn 🇮🇳 Indien Preview 🇮🇩 Indonesien Preview 🇮🇪 Irland 🇮🇹 Italien 🇯🇵 Japan 🇰🇪 Kenia Erweitertes Netzwerk 🇱🇻 Lettland 🇱🇮 Liechtenstein 🇱🇹 Litauen 🇱🇺 Luxemburg 🇲🇾 Malaysia 🇲🇹 Malta 🇲🇽 Mexiko 🇳🇱 Niederlande 🇳🇿 Neuseeland 🇳🇬 Nigeria Erweitertes Netzwerk 🇳🇴 Norwegen 🇵🇱 Polen 🇵🇹 Portugal 🇷🇴 Rumänien 🇸🇬 Singapur 🇸🇰 Slowakei 🇸🇮 Slowenien 🇿🇦 Südafrika Erweitertes Netzwerk 🇪🇸 Spanien 🇸🇪 Schweden 🇨🇭 Schweiz 🇹🇭 Thailand 🇦🇪 Vereinigte Arabische Emirate 🇬🇧 Vereinigtes Königreich 🇺🇸 Vereinigte Staaten

Schritt 2: Dein erstes Produkt erstellen

Sobald deine Payment Entity den Status active hat, wechsle zum Tab Products und erstelle ein Produkt. Jedes Produkt hat mindestens eine Variante (einen Preistarif) mit:

• Einem Preis in der kleinsten Währungseinheit (z. B. Cent)
• Einer Währung (USD, EUR, GBP usw. — vollständige Liste im SDK)
• Entweder einem einmaligen Preis oder einem wiederkehrenden Abrechnungsintervall (Woche, Monat oder Jahr)
• Optionalen Features, die beim Kauf Berechtigungen vergeben (siehe Products & Features)

Du kannst Produkte über das Panel erstellen oder die KI beauftragen: "Create a Pro plan at $29/month and a Business plan at $99/month."

Schritt 3: Checkout in deine App einbinden

Verwende das Proyecta SDK in deinem App-Code, um eine Checkout-Sitzung zu starten und Berechtigungen zu prüfen. Code-Beispiele findest du unter Integrate Into My App.

Was im Lieferumfang enthalten ist

• Stripe Connect Onboarding mit KYC, Verifizierung und Bankkonto-Einrichtung
• Produkte mit Varianten — einmalig, wiederkehrend, kostenlos
• Coupons — prozentualer oder fester Rabatt, einmalig/wiederkehrend/unbegrenzt, Einlösungslimits, Ablaufdaten
• Customers — zahlungspflichtige Nutzer deiner App
• Transaktionen mit Rückerstattungsunterstützung
• Features — wiederverwendbare Berechtigungen, die du mehreren Produkten zuweisen kannst

Was noch entwickelt wird

• Payouts-Dashboard im Builder (Auszahlungen werden derzeit über dein verbundenes Stripe Dashboard verwaltet)
• Testmodus-Umschalter mit Testkarten
• Benutzeroberfläche für Statement-Descriptor-Einstellungen
• Kundenportal für die Abrechnung
• Compliance-Dashboard über Stripes Onboarding-Prozess hinaus
• Support-Posteingang im Builder für commerce-spezifische Anliegen

Preise

Proyecta Commerce verwendet intern Stripe. Du zahlst die Standardbearbeitungsgebühren von Stripe. Proyecta Commerce erhebt zusätzlich zu den Standardbearbeitungsgebühren von Stripe eine Plattformgebühr von 2 % pro Transaktion.