Zum Inhalt springen
All articles
Setup

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

  1. Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte „Zahlungen (Stripe)“.
  2. Fügen Sie Ihren Stripe Secret Key ein und klicken Sie auf „Schlüssel speichern“.
  3. 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.
  4. Kehren Sie zum CRM zurück, fügen Sie das Webhook Signing Secret (whsec_...) zusammen mit dem Secret Key ein und speichern Sie erneut.
  5. Klicken Sie auf „Aktivieren“.
  1. Öffnen Sie eine Opportunity und wechseln Sie zum Bereich Angebote.
  2. 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.
  3. Senden Sie den Link an den Kunden. Sobald er zahlt, benachrichtigt Stripe das CRM per Webhook, und die Zahlung erscheint im Angebot als „Bezahlt“.
💡 Wenn Sie versuchen, einen Link zu erstellen, ohne Stripe konfiguriert zu haben, warnt Sie das CRM deutlich, und es wird nichts berechnet. Die Funktion bleibt inaktiv, bis der Schlüssel vorhanden ist. Wird eine mit einem Angebot verknüpfte Zahlung bestätigt, wird das Angebot automatisch als angenommen markiert.

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

  1. Verwenden Sie die TEST-Schlüssel (sk_test_.../whsec_ aus dem Testmodus), um nicht wirklich zu berechnen.
  2. Erstellen Sie einen „Zahlungslink“ für ein Angebot und öffnen Sie ihn: Sie sollten beim Stripe-Checkout mit dem Gesamtbetrag des Angebots landen.
  3. 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.
  4. 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.

Open this article inside the system

Read it and want to see it working?

The account is free and the whole manual is available inside the system, with an assistant that answers from this very content.

Kostenloses Konto erstellen
Zahlungen (Stripe) · Sellio