Stripe Kundenzahlungen einrichten
Diese Anleitung erklärt, wie ein Workspace den Stripe-Account eines Kunden für Kaufprüfung und Zahlungsnachweise verbindet. Es geht nicht um GramGrows eigene Abo-Abrechnung.
Wichtig
Was Stripe in GramGrow macht
GramGrow nutzt die hinterlegten Stripe-Credentials, um im Purchase Checker Zahlungsnachweise zu prüfen. Ein Operator kann damit z. B. kontrollieren, ob eine Kunden-E-Mail eine erfolgreiche Stripe-Zahlung hat und ob diese Zahlung zur Membership- oder Access-Entscheidung passt.
Geeignet für
Testkäufe, Purchase Checks, Support-Fälle und manuelle Revenue-Prüfung.
Nicht dasselbe wie
GramGrow Plan-Billing oder ein fertiger Stripe-Webhook-Ingest. Stripe Connect ist ein eigener Onboarding-Pfad, nicht dieselbe UI wie der API-Key-Fallback.
Stripe Connect vs. API-Key-Fallback
Es gibt drei getrennte Stripe-Kontexte: GramGrow Billing bezahlt den GramGrow-Workspace; Customer Payments prüft Zahlungen im Stripe-Account des Kunden oder Projekts; Stripe Connect ist der geführte Weg, einen Kunden-Stripe-Account ohne manuelles Secret-Handling zu verbinden.
Wenn Stripe Connect für den Workspace nicht verfügbar oder noch nicht abgeschlossen ist, nutzt GramGrow den API-Key-Fallback: ein Secret oder Restricted Key wird im Workspace gespeichert und ausschließlich für Purchase Checker, Re-check und lesende Zahlungsnachweise verwendet.
Schritte in Stripe
- Öffne den richtigen Stripe-Account. Verwende für Tests den Sandbox- bzw. Testmodus.
- Gehe zu Developers -> API keys. Kopiere nicht den Publishable Key als Secret.
- Nutze für einen schnellen Test einen Secret Key mit sk_test_... oder besser einen Restricted Key mit rk_test_....
- Wenn du einen Restricted Key verwendest, gib mindestens Leserechte für Customers und PaymentIntents frei, damit GramGrow Zahlungen suchen kann.
- Für Stripe Connect: Öffne Connect -> Onboarding options -> OAuth und aktiviere OAuth für Standard-Accounts. Trage dort exakt dieselbe Redirect-URI ein, die als STRIPE_CONNECT_REDIRECT_URL auf dem API-Server konfiguriert ist.
- Achte darauf, dass Connect Client ID, Secret Key und Redirect-URI im selben Stripe-Modus liegen. Test-/Sandbox-Client-IDs funktionieren nicht mit Live-Keys und umgekehrt.
- Setze STRIPE_CONNECT_OAUTH_SCOPE auf read_write, solange Stripe read_only nicht explizit für deine Connect-Integration freigeschaltet hat. GramGrow verwendet die Verbindung weiterhin nur für Zahlungsprüfungen.
Standard OAuth deaktiviert
Testmodus zuerst
Felder in GramGrow
| GramGrow-Feld | Was eintragen | Zweck |
|---|---|---|
| Publishable Key (optional) | pk_test_... | Nur Referenz. Der Re-check authentifiziert sich nicht damit. |
| Secret oder Restricted Key | sk_test_... / rk_test_... | Erforderlich für Re-check und Purchase Checker API-Lookups. |
Verbindung testen
Speichere die Stripe-Credentials in Settings -> Payments und klicke danach Re-check. Ein erfolgreicher Re-check bedeutet: GramGrow kann Stripe mit dem gespeicherten Secret oder Restricted Key erreichen.
Expected setup result
Stripe card: Connected
Last checked: current timestamp
Last successful check: current timestampPurchase Checker
Nach dem erfolgreichen Re-check kannst du im Purchase Checker eine Kunden-E-Mail prüfen. GramGrow sucht den Stripe-Customer und erfolgreiche PaymentIntents. Für einen sinnvollen Test muss im selben Stripe-Testaccount ein Test-Customer mit erfolgreicher Testzahlung existieren.
Stripe Webhooks
Fehlerbehebung
Re-check bleibt rot
Prüfe, ob der Secret/Restricted Key aus demselben Stripe-Modus stammt wie deine Testdaten.
Publishable Key wurde als Secret eingefügt
Publishable Keys beginnen mit pk_ und können Stripe API-Lookups nicht authentifizieren. Nutze sk_ oder rk_.
Purchase Checker findet keinen Kauf
Lege im gleichen Stripe-Testaccount einen Customer mit derselben E-Mail und einer erfolgreichen Testzahlung an.