Schnittstellen
Stripe verbinden
Deine Kunden bezahlen Rechnungen online über dein Stripe-Konto, VentionDesk bucht die Zahlung.
Wo du verbindest
In VentionDesk unter Betrieb › Quellen › „Quelle hinzufügen“, Kategorie Zahlung, dann Stripe. Verbinden, bearbeiten und entfernen darf nur der Inhaber.
Schritt für Schritt
- Lege in Stripe unter Developers › API keys einen eingeschränkten Schlüssel „VentionDesk" an. Er braucht genau diese Rechte, alles andere bleibt „None": Checkout Sessions: Schreiben (legt die Bezahlseite an); PaymentIntents: Lesen (prüft vor einer Erstattung, was noch offen ist); Charges: Lesen (liest, was dort schon erstattet ist); Refunds: Schreiben (erstattet aus VentionDesk).
- Trage den Schlüssel hier ein und speichere. VentionDesk prüft ihn mit einer Abfrage der Checkout-Sitzungen; es wird dabei nichts belastet. Ein Test-Schlüssel (rk_test_…) ist erlaubt: Dann gibt es nur den Testlink an der Rechnung, Mail und Beleg bleiben ohne Link.
- Klicke danach unter „Quellen" › Stripe auf „Webhook-Adresse zeigen" und lege sie in Stripe unter Developers › Webhooks › „Add endpoint" an, mit genau diesen Ereignissen: checkout.session.completed, checkout.session.async_payment_succeeded, checkout.session.async_payment_failed, charge.refunded.
- Kopiere das „Signing secret" (whsec_…) des Endpunkts und speichere die Anbindung mit Schlüssel und Signing Secret erneut. Erst dann steht der Bezahllink in Rechnungsmail und Beleg: Ohne Webhook käme eine Zahlung an, ohne dass VentionDesk sie bucht.
- Das Geld geht auf dein Stripe-Konto. VentionDesk bucht jede Zahlung und jede Erstattung auf die Rechnung und schickt Stripe nur Rechnungsnummer, Betrag und die E-Mail-Adresse des Kunden.
Was der Dialog abfragt
| Feld | Angabe | Woher |
|---|---|---|
| Eingeschränkter Schlüssel | Pflicht · geheim | Developers › API keys › „Create restricted key" (rk_live_… bzw. rk_test_…). Ein Secret Key (sk_…) geht auch, darf aber alles. |
| Signing Secret des Webhooks | freiwillig · geheim | Steht nach dem Anlegen des Endpunkts unter Developers › Webhooks › dein Endpunkt › „Signing secret" (whsec_…). Leer lassen behält das bisherige. |
Geheime Angaben speichert VentionDesk verschlüsselt und zeigt sie nie wieder an. Gespeichert wird erst, wenn der Anbieter den Zugang bestätigt; wer eine Anbindung bearbeitet und ein geheimes Feld leer lässt, behält den bisherigen Wert.
Alle Anbieter im Überblick: Schnittstellen · Webhook-Adressen: Webhooks