Zuerst den richtigen Anwendungsfall prüfen
Möchten Sie nur Ihr CloudCRM-Abo per Karte oder SEPA bezahlen, öffnen Sie „Paket & Rechnungen“. Dafür benötigen Sie keine eigenen Stripe-API-Schlüssel. Die folgende Anleitung richtet sich an Firmenadministratoren, die ihren eigenen Kunden Onlinezahlungen auf Rechnungen anbieten möchten. Sie benötigen ein passendes Stripe-Konto, die dazugehörigen Rechte und die Freigabe für die CloudCRM-Unternehmenseinstellungen.
Die Anbindung in CloudCRM vorbereiten
Die Stripe-Karte öffnen
Wählen Sie „Profil → Unternehmen“ und dort „Stripe (Online-Zahlung)“. Die Karte bietet Aktivierung, Modus, Währung, öffentlichen Schlüssel, geheimen API-Schlüssel und Webhook-Signatur.
Test und Live sauber trennen
Verwenden Sie die zum ausgewählten Modus passenden Schlüssel und die passende Webhook-Konfiguration. Prüfen Sie die Einrichtung zuerst mit dafür vorgesehenen Testvorgängen. Ein Testschlüssel verarbeitet keine echte Zahlung im Livekonto.
Die eigenen Schlüssel zuordnen
Übernehmen Sie öffentlichen und geheimen Schlüssel aus dem zu Ihrer Firma gehörenden Stripe-Konto. Die Webhook-Signatur gehört zum konkreten eingerichteten Endpunkt. Veröffentlichen Sie geheime Schlüssel nicht in Nachrichten oder Screenshots.
Einstellungen gezielt speichern
Prüfen Sie die Währung und verwenden Sie „Stripe speichern“. Leere Geheimnisfelder behalten laut Formular den bestehenden Wert bei. Eine leere Anzeige bedeutet daher nicht automatisch, dass noch kein Schlüssel gespeichert ist.
Zahlungsbestätigungen per Webhook anbinden
Stripe meldet Zahlungsergebnisse über einen Webhook. Die für diese CloudCRM-Installation vorgesehene Adresse lautet https://cloudcrm.dwoberland.de/webhooks/stripe_webhook.php. Verwenden Sie im Stripe-Dashboard den Webhooks-Bereich von Workbench und richten Sie ein Ereignisziel für Ihr eigenes Konto mit klassischen Snapshot-Ereignissen ein. Der zugehörige Signierschlüssel beginnt mit whsec_ und gehört in „Webhook-Signatur“. Die aktuelle Navigation beschreibt Stripe in der Webhook-Anleitung.
Die aktuelle CloudCRM-Verarbeitung berücksichtigt nicht nur checkout.session.completed. Für die hier unterstützten Checkout- und Zahlungsabläufe sind außerdem checkout.session.async_payment_succeeded, checkout.session.async_payment_failed, checkout.session.expired, payment_intent.processing, payment_intent.succeeded, payment_intent.payment_failed und payment_intent.canceled relevant. Verwendet die konkrete Einrichtung zusätzlich Stripe-Rechnungsereignisse, sind auch invoice.paid und invoice.payment_failed mit der Administration abzustimmen. Eine Einrichtung ausschließlich für das erste Ereignis deckt verzögerte Zahlungsergebnisse nicht vollständig ab.
Rückkehrseite und tatsächliche Zahlung unterscheiden
Erfolgs- und Abbruch-URL werden von CloudCRM aus der Systemadresse verwaltet. Die Rückkehr auf eine Erfolgsseite allein bestätigt keine Zahlung. Erst das geprüfte Zahlungsergebnis und seine Zuordnung zum passenden offenen Beleg bestimmen die Verbuchung. Bei verzögerten Verfahren kann eine Zahlung zunächst in Bearbeitung bleiben. Die im Checkout angebotenen Zahlungsarten richten sich nach der konkreten Stripe-Einrichtung; eine bestimmte Wallet ist nicht bei jedem Gerät und Konto automatisch verfügbar.
Nach der Einrichtung kontrollieren
Prüfen Sie an einem geeigneten Testbeleg Zahlungslink, Betrag und die Rückmeldung. Vergleichen Sie anschließend den Zahlungsstatus in CloudCRM und die Ereigniszustellung in Stripe. Bei Unklarheiten benötigen Sie Belegnummer, Zeitpunkt und Fehlermeldung. Ändern Sie keine Rechnung manuell auf bezahlt, nur weil ein Browserfenster erfolgreich zurückgekehrt ist.