NAiOS Wallet
walletv0.2.0Zahlungen als Dienstleistung (Connect-as-a-service): verbundene Stripe-Konten, Abrechnung mit Verteilung (Provision + Netto), Auszahlungen und Hauptbuch. Zahlungsabwicklung des Marktplatzes von NAiOS Academy.
Beschreibung
NAiOS Wallet ist die Zahlungsabwicklung der Plattform: ein Zahlungsdienst wie Stripe Connect-as-a-service, der von anderen Plugins im Prozess genutzt wird (heute NAiOS Academy). Was es macht: • Verbundene Konten (Stripe Connect Express): Onboarding über AccountLink und synchroner Echtzeitstatus von Stripe (Zahlungen/Auszahlungen aktiviert → aktiv). • Abrechnung mit Verteilung: Jeder Verkauf weist die Provision der Plattform und das Netto des Begünstigten aus; unterstützt die Verteilung an mehrere Akteure (Co-Lehrende eines Kurses, Referenten einer Veranstaltung). • Auszahlungen: Der Verkäufer hebt sein verfügbares Guthaben durch Überweisung auf das verbundene Konto ab. • Hauptbuch in Cent: verdientes / verfügbares / ausgezahltes Guthaben, mit konfigurierbarer Standardprovision. • Nachverfolgbarkeit: Jede Zahlung speichert eine lesbare Herkunft und eine URL zur ursprünglichen Ressource (das Panel verlinkt zum Verkauf). • Anbieteranpassung: 'simuliert' in der Entwicklung (funktioniert ohne Schlüssel, sofortiges Onboarding) ↔ 'stripe-connect' real; wenn kein eigener Schlüssel vorhanden ist, wird der des Billing-Plugins wiederverwendet. Sicherheit: Die Schlüssel gelangen niemals in den Browser und die Auszahlungen erfordern ein aktives Zahlungsabwicklungskonto. API im Prozess: recordSale / recordSaleSplit / payeeBalance / onboard / accountStatus. Web/QR TPV und Tap to Pay sind für spätere Phasen vorgesehen.
Funktionen (8)
Onboarding über AccountLink und synchroner Echtzeitstatus von Stripe: das Konto wird aktiv, wenn Zahlungen und Auszahlungen aktiviert sind.
Jeder Verkauf trennt die Provision der Plattform vom Netto des Begünstigten; unterstützt die Verteilung an mehrere Begünstigte.
Der Verkäufer hebt sein verfügbares Guthaben durch Überweisung auf das verbundene Konto ab; in der Entwicklung erfolgt die Auszahlung sofort.
Verdientes / verfügbares / ausgezahltes Guthaben pro Begünstigten, mit konfigurierbarer Standardprovision.
Jede Zahlung speichert eine lesbare Herkunft (z. B. „Kurs: …“) und eine URL zur ursprünglichen Ressource; das Panel verlinkt zum Verkauf.
'simuliert' in der Entwicklung (ohne Schlüssel) ↔ 'stripe-connect' real. Wenn kein eigener Schlüssel vorhanden ist, wird der des Billing wiederverwendet.
Andere Plugins nutzen recordSale / recordSaleSplit / payeeBalance / onboard / accountStatus ohne HTTP.
Die Schlüssel gelangen niemals in den Browser; die Auszahlungen erfordern ein aktives Zahlungsabwicklungskonto.
Changelog
- Anbieter 'stripe-connect' REAL: Onboarding Express (accounts.create + AccountLink), accountStatus durch accounts.retrieve und Auszahlung durch Überweisung auf das verbundene Konto
- Fallback des Schlüssels: Wenn das Wallet keinen stripe_secret_key hat, wird der des Billing-Plugins wiederverwendet (gleicher Sandbox/Produktionskonto, ohne Duplikate)
- Synchronisierung des Kontostatus beim Zurückkehren vom Onboarding (pending → active) und echte Weiterleitung zu Stripe von der UI
- Nachverfolgbarkeit: neue Spalte ref_url im Hauptbuch; die Spalte Herkunft des Panels verlinkt zur ursprünglichen Ressource jedes Verkaufs
- Smoke-Tests des Anbieters + Schlüsselauflösung (Mock des SDK, ohne Netzwerk)
- F1 lean: Connect-as-a-service im 'simulierten' Modus — verbundene Konten, Abrechnung mit Verteilung (Provision + Netto) und Hauptbuch der Auszahlungen
- API des Dienstes im Prozess, genutzt von NAiOS Academy
- Verkäuferpanel: Kontostatus, Guthaben (verdient/verfügbar/ausgezahlt), Auszahlung und Verkäufe