Zahlungen (Stripe)
Erstellen Sie Zahlungslinks für Angebote mit Ihrem eigenen Stripe-Konto (BYO-Modell).
Die Zahlungen-Integration nutzt IHR Stripe-Konto (BYO-Modell: Sie bringen Ihr eigenes Konto mit). Zahlungen fließen direkt in Ihr Stripe-Konto: Es gibt keine Kosten, keine Marge und keine Vermittlung unsererseits. Wir verdrahten nur die Felder und den Button zum Erstellen des Links.
Die Integration startet inaktiv: Nichts passiert, bis Sie Ihren Schlüssel einfügen und aktivieren. Die Schlüssel werden verschlüsselt im CRM gespeichert und nie erneut angezeigt.
Voraussetzungen
- Ein aktives Stripe-Konto (um wirklich Zahlungen abzuwickeln, muss das Konto in Ihrem Land für Zahlungen freigeschaltet sein).
- Zugriff auf das Stripe-Dashboard mit Berechtigung, API-Schlüssel einzusehen (Developers → API keys) und Webhooks zu erstellen (Developers → Webhooks).
- In Sellio: Administratorzugriff, um die Schlüssel zu speichern und die Integration unter Einstellungen → Integrationen zu aktivieren.
Was Sie einfügen müssen
- Secret key: im Stripe-Dashboard unter Developers → API keys (beginnt in Produktion mit sk_live_, im Testmodus mit sk_test_).
- Webhook signing secret (anfangs optional): wird erzeugt, wenn Sie den Webhook in Stripe erstellen (beginnt mit whsec_). Es ermöglicht die automatische Bestätigung von Zahlungen.
Konfiguration
- Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte „Zahlungen (Stripe)“.
- Fügen Sie Ihren Stripe Secret Key ein und klicken Sie auf „Schlüssel speichern“.
- Kopieren Sie die angezeigte „Stripe-Webhook-URL“ und erstellen Sie im Stripe-Dashboard (Developers → Webhooks) einen Endpunkt für diese URL mit den Ereignissen checkout.session.completed und payment_intent.succeeded.
- Kehren Sie zum CRM zurück, fügen Sie das Webhook Signing Secret (whsec_...) zusammen mit dem Secret Key ein und speichern Sie erneut.
- Klicken Sie auf „Aktivieren“.
So erstellen Sie einen Zahlungslink
- Öffnen Sie eine Opportunity und wechseln Sie zum Bereich Angebote.
- Klicken Sie bei der gewünschten Version auf „Zahlungslink“: Das CRM erstellt einen Link in Stripe mit dem Gesamtbetrag des Angebots und kopiert ihn in Ihre Zwischenablage.
- Senden Sie den Link an den Kunden. Sobald er zahlt, benachrichtigt Stripe das CRM per Webhook, und die Zahlung erscheint im Angebot als „Bezahlt“.
Behandeln Sie die Webhook-URL als geheim und fügen Sie beim Ändern immer beide Schlüssel zusammen ein (aus Sicherheitsgründen zeigt das CRM die gespeicherten Schlüssel nicht erneut an).
So testen Sie
- Verwenden Sie die TEST-Schlüssel (sk_test_.../whsec_ aus dem Testmodus), um nicht wirklich zu berechnen.
- Erstellen Sie einen „Zahlungslink“ für ein Angebot und öffnen Sie ihn: Sie sollten beim Stripe-Checkout mit dem Gesamtbetrag des Angebots landen.
- Zahlen Sie mit einer Stripe-Testkarte (z. B. 4242 4242 4242 4242). Bestätigen Sie, dass das Angebot „Bezahlt“ wird und als angenommen markiert ist, ein Zeichen, dass der Webhook angekommen ist und die Signatur stimmte.
- Sehen Sie im Stripe-Dashboard (Developers → Webhooks → Ihr Endpunkt) den Verlauf der zugestellten Ereignisse und den Status 200.
Fehlerbehebung
- Fehler beim Erstellen des Links / 401 bei Stripe: Der Secret Key ist falsch oder stammt aus dem anderen Modus (Sie haben den Test-Schlüssel eingefügt, sind aber in Produktion, oder umgekehrt). Fügen Sie den korrekten sk_ erneut ein.
- Der Kunde zahlt, aber das Angebot wird nicht „Bezahlt“: Der Webhook bestätigt nicht. Prüfen Sie, ob Sie den Endpunkt in Stripe erstellt haben, der auf die „Stripe-Webhook-URL“ zeigt, mit den Ereignissen checkout.session.completed und payment_intent.succeeded.
- Ungültige Signatur beim Webhook: Das Webhook Signing Secret (whsec_...) im CRM stimmt nicht mit dem des Endpunkts in Stripe überein. Kopieren Sie das Secret des Endpunkts und fügen Sie es ZUSAMMEN mit dem Secret Key ein (beide zusammen speichern).
- 404 bei der Webhook-URL: Die Integration ist nicht aktiviert, oder das URL-Token hat sich geändert. Reaktivieren Sie und kopieren Sie die URL erneut zu Stripe.
- Beim Erstellen des Links passiert nichts: Die Integration ist mangels Schlüssel inaktiv. Fügen Sie zuerst den Secret Key ein und aktivieren Sie.