Files

T

DogFatherGitandClaude Opus 5 321e378f9b Zahlungen: Routen, Zustimmung nach § 356 Abs. 4 und Einrichtungsanleitung

Das PayPal-Modul und die Tabellen standen seit dem 22.08.2026 -- es
fehlten die Wege dorthin. Jetzt vollstaendig.

DREI DINGE, DIE HIER ANDERS SIND ALS BEI EINEM UEBLICHEN BEZAHLKNOPF

1. DIE ZUSTIMMUNG IST TEIL DER ZAHLUNG, kein Haekchen daneben.

   Die 30-%-Anzahlung wird faellig, BEVOR die Widerrufsfrist ablaeuft.
   Damit trotzdem sofort begonnen werden darf, verlangt § 356 Abs. 4 BGB
   die ausdrueckliche Zustimmung UND die Bestaetigung, dass der
   Verbraucher dadurch sein Widerrufsrecht verliert. Die Beweislast fuer
   beides liegt beim Unternehmer.

   Gespeichert wird deshalb nicht "hat zugestimmt", sondern der
   WORTLAUT, den der Kunde gesehen hat, samt Fassung und Zeitstempel.
   Im Streit zaehlt nicht DASS, sondern WOZU jemand zugestimmt hat --
   und Texte aendern sich ueber die Jahre.

   Der Wortlaut steht auf dem SERVER, nicht im Browser: Was als Nachweis
   gespeichert wird, muss das sein, was der Server kennt, sonst koennte
   man ihm einen beliebigen Text unterschieben.

   Geschaeftskunden werden gar nicht erst gefragt. Ein Unternehmer hat
   kein Widerrufsrecht; ihn eine Verzichtserklaerung unterschreiben zu
   lassen waere sinnlos und wuerde nur Misstrauen wecken.

2. NICHT EINGERICHTET IST EIN ZUSTAND, KEIN FEHLER.

   Ohne Zugangsdaten sagt die Seite das freundlich und nennt den Weg
   ueber das Postfach. Ein Knopf, der eine technische Fehlermeldung
   wirft, sieht nach einer kaputten Seite aus -- und niemand bezahlt gern
   auf einer kaputten Seite.

3. DER WEBHOOK IST DIE WAHRHEIT, nicht die Rueckkehr des Browsers.

   Der Kunde kann das Fenster schliessen, bevor er zurueckgeleitet wird.
   Die Zahlung ist dann trotzdem erfolgt. Beide Wege schreiben ueber
   DIESELBE Funktion -- zwei getrennte Fassungen wuerden frueher oder
   spaeter auseinanderlaufen und unterschiedliche Felder setzen.

   Doppelte Zustellung ist bei PayPal normal. Die Merkliste verhindert
   die Doppelverbuchung, und "verarbeitet" wird erst NACH der Auswertung
   gesetzt: Bricht der Server dazwischen ab, steht die Meldung als
   empfangen-aber-offen da und faellt auf, statt spurlos als "schon
   behandelt" zu gelten.

Ohne gueltige Signatur wird nichts verarbeitet -- sonst koennte jeder
eine Zahlung als bezahlt melden.

GEPRUEFT: 26 Pruefungen auf dem Server, alle bestanden. Bewusst OHNE
PayPal-Zugangsdaten, weil genau das der heutige Zustand ist. Geprueft
wird vor allem, was NICHT passieren darf: kein Bezahlvorgang ohne
Zustimmung, keine Zustimmungsfrage an Geschaeftskunden, keine fremde
Zahlung sichtbar, keine Doppelverbuchung, kein Geldfluss ohne
Zugangsdaten -- und dass ein gescheiterter Versuch die Zahlung
unangetastet auf "offen" laesst.

ANLEITUNG: PAYPAL-EINRICHTEN.md, Schritt fuer Schritt mit den genauen
Klicks. Sie nennt ausdruecklich die drei Fallen, die man sonst erst
spaeter merkt: der Sandbox-Schalter (Zugangsdaten ohne echtes Geld),
"Select all" bei den Webhook-Ereignissen (erzeugt Rauschen, in dem echte
Probleme untergehen) und Client-ID und Secret aus verschiedenen Apps.

Das Secret gehoert nach Bitwarden -- die Anleitung sagt das an drei
Stellen und bietet an, dass Filipe es selbst eintraegt, ohne es mir zu
zeigen.

Co-Authored-By: Claude Opus 5 <[email protected]>

2026-08-23 16:24:51 +02:00

7.2 KiB

Raw Blame History

PayPal für den Webdesign-Bereich einrichten

Das ist der einzige Schritt, den ich nicht selbst machen kann: PayPal lässt Zugangsdaten nur über dein eingeloggtes Konto erzeugen.

Alles andere steht bereits — Bestellungen, Einzug, Webhook mit Signaturprüfung, Schutz gegen Doppelverbuchung, die gesetzlich nötige Zustimmung vor der Anzahlung. Sobald die vier Werte eingetragen sind, funktionieren die Bezahlknöpfe.

Zeitbedarf: etwa 20 Minuten. Kosten: keine — ein PayPal-Geschäftskonto ist kostenlos, Gebühren fallen nur pro Zahlung an.

Bevor du anfängst

Du brauchst ein PayPal-Geschäftskonto (kein privates). Falls du noch keins hast: Auf paypal.com anmelden → Einstellungen → Kontoart ändern → auf Geschäftskonto umstellen. Das geht mit demselben Konto und kostet nichts.

Wichtig: Das Geld landet direkt auf deinem PayPal-Konto. Es geht zu keinem Zeitpunkt über einen Vermittler oder über mich.

Schritt 1 — Bei den Entwickler-Einstellungen anmelden

Gehe auf https://developer.paypal.com
Oben rechts auf Log in to Dashboard
Melde dich mit deinen ganz normalen PayPal-Zugangsdaten an (denselben wie auf paypal.com)

Du landest im Developer Dashboard.

Schritt 2 — Auf „Live" umschalten

Oben auf der Seite gibt es einen Schalter mit zwei Stellungen:

   Sandbox   |   Live

Stelle ihn auf „Live".

Sandbox ist die Spielwiese mit Testgeld. Solange der Schalter dort steht, erzeugst du Zugangsdaten, mit denen kein echtes Geld fliesst. Das ist der häufigste Fehler bei dieser Einrichtung.

Schritt 3 — App anlegen

Klicke links auf Apps & Credentials
Klicke auf Create App
App Name: Dogfather Webdesign
Type: Merchant (falls gefragt)
Klicke Create App

Du siehst jetzt zwei Werte:

Feld	Was du siehst
Client ID	eine lange Zeichenkette, sofort sichtbar
Secret	daneben ein Link Show — draufklicken

Beide brauche ich. Kopiere sie zunächst irgendwohin, wo du sie gleich wiederfindest.

Das Secret ist wie ein Passwort. Schick es mir nicht im Chat. Wie du es sicher hinterlegst, steht in Schritt 6.

Schritt 4 — Webhook einrichten

Der Webhook ist die Leitung, über die PayPal uns meldet: „Die Zahlung ist durch." Ohne ihn würde eine Zahlung nicht als bezahlt erscheinen, wenn der Kunde das Fenster zu früh schliesst.

Auf derselben App-Seite nach unten scrollen zu Webhooks
Klicke Add Webhook
Webhook URL — genau das hier eintragen:

https://postfach.dogfather-universe.com/webdesign/paypal-webhook

Bei Event types wähle diese vier aus:
- Payment capture completed
- Payment capture denied
- Payment capture refunded
- Billing subscription cancelled
Nicht „Select all" anklicken. Jedes zusätzliche Ereignis erzeugt Meldungen, die niemand auswertet — das macht die Suche nach einem echten Problem später unnötig schwer.
Save
Danach erscheint in der Liste eine Webhook ID (beginnt meist mit WH-). Die brauche ich auch.

Schritt 5 — Nur falls du die monatliche Betreuung anbieten willst

Für einmalige Zahlungen (Anzahlung, Restbetrag, Zusatzleistungen) bist du hier fertig. Das monatliche Betreuungs-Abo braucht zusätzlich einen Plan:

Links auf Products & Plans (oder direkt unter Subscriptions)
Create Product → Name Dogfather Betreuung, Type Service
Dann Create Plan → monatlich, Preis eintragen
Die Plan ID (beginnt mit P-) notieren

Das kannst du auch später nachholen — die Einmalzahlungen laufen ohne.

Schritt 6 — Werte sicher hinterlegen

Die Zugangsdaten gehören in eine Datei auf dem Server, nicht in den Chat und nicht ins Git.

Du hast zwei Möglichkeiten:

Möglichkeit A — du trägst sie selbst ein

ssh dogi@<server>
sudo -u dogiintern nano /home/dogiintern/dogfather-universe/server-internal/.env

Diese Zeilen ergänzen bzw. ausfüllen:

PAYPAL_ENV=live
PAYPAL_CLIENT_ID=<Client ID aus Schritt 3>
PAYPAL_CLIENT_SECRET=<Secret aus Schritt 3>
PAYPAL_WD_WEBHOOK_ID=<Webhook ID aus Schritt 4>
PAYPAL_WD_PLAN_BASIS=<Plan ID aus Schritt 5, sonst leer lassen>

Speichern (Strg+O, Enter, Strg+X), dann:

sudo systemctl restart dogiintern.service

Möglichkeit B — über Bitwarden

Leg die vier Werte in Bitwarden ab und sag mir Bescheid. Ich sage dir dann, welche Zeile wohin gehört — die Werte selbst brauche ich nicht zu sehen.

Schritt 7 — Prüfen, ob es angekommen ist

Melde dich in der Verwaltung an und öffne den Bereich Zahlungen. Oben steht der Einrichtungsstand:

„PayPal ist eingerichtet" → fertig
„Es fehlt noch: …" → dort steht, welcher Wert leer ist

Schritt 8 — Der erste echte Test

Mach die erste Zahlung mit einem kleinen Betrag an dich selbst.

Leg in der Verwaltung ein Testprojekt mit 1,00 € Preis an
Erzeuge dazu eine Zahlung
Bezahle sie im Portal mit einem anderen PayPal-Konto (z. B. dem von VanVan) oder mit Karte als Gast
Prüfe: Kommt das Geld an? Steht die Zahlung auf „bezahlt"?
Erstatte den Betrag in PayPal wieder zurück

Ein Testlauf mit echtem Geld ist der einzige Weg, der wirklich etwas beweist. Die Sandbox verhält sich in Kleinigkeiten anders — und diese Kleinigkeiten fallen sonst beim ersten echten Kunden auf.

Was passiert, wenn ein Kunde zahlt

Kunde klickt im Portal auf Jetzt bezahlen
Bei der Anzahlung muss er zuerst bestätigen, dass sofort begonnen werden darf und er dadurch sein Widerrufsrecht verliert (§ 356 Abs. 4 BGB — der genaue Wortlaut wird mit Zeitstempel gespeichert, weil im Streit du beweisen musst, dass er zugestimmt hat)
Er wird zu PayPal geleitet und bezahlt
Das Geld geht sofort auf dein Konto — es gibt keine Zwischenstufe
Die Zahlung erscheint als „bezahlt", das Projekt vermerkt Anzahlung bzw. Restbetrag als eingegangen

Schliesst der Kunde das Fenster zu früh, meldet der Webhook die Zahlung trotzdem. Kommt dieselbe Meldung doppelt — was bei PayPal normal ist — wird sie nur einmal verbucht.

Wenn etwas nicht klappt

Anzeichen	Ursache	Abhilfe
„noch nicht freigeschaltet"	Werte fehlen oder Dienst nicht neu gestartet	Schritt 6 wiederholen, Dienst neu starten
Zahlung bleibt auf „freigegeben"	Webhook-Adresse falsch	Schritt 4 prüfen — die Adresse muss exakt stimmen
Kein echtes Geld	Schalter stand auf Sandbox	Schritt 2, dann neue Zugangsdaten erzeugen
PayPal meldet „invalid client"	Client ID und Secret aus verschiedenen Apps	beide aus derselben App neu kopieren

Zwei Dinge, die dauerhaft gelten

Das Secret ist ein Passwort. Es gehört nach Bitwarden, nicht in eine Notiz, nicht in eine Nachricht, nicht ins Git. Wenn es je irgendwo auftaucht, wo es nicht hingehört: in der App Manage Credentials → new secret erzeugen und das alte löschen.

Prüfe nach dem Umstellen auf Live einmal deinen Kontoauszug. Nicht weil zu erwarten wäre, dass etwas schiefgeht — sondern weil der Moment, in dem zum ersten Mal echtes Geld fliessen kann, der richtige ist, um einmal genau hinzusehen.

7.2 KiB Raw Blame History