Gumroad Kundenzahlungen einrichten
Diese Anleitung erklärt, wie du Gumroad für Kaufprüfung, Webhook-Ereignisse und Membership-Entscheidungen verbindest. Gumroad benötigt in GramGrow nur einen Access Token.
Wichtig
Was Gumroad in GramGrow macht
GramGrow nutzt Gumroad, um Verkäufe und Zahlungsänderungen einem Kontakt, einer Membership oder einem Access-Ziel zuzuordnen. Der Access Token wird für API-Lookups genutzt. Webhook-Ereignisse halten spätere Änderungen wie Refunds, Disputes und Abo-Status aktuell.
Geeignet für
Kaufprüfung, Membership-Sync, Support-Fälle und manuelle Access-Entscheidungen.
Sicherheitsgrenze
Speichere nur den Gumroad Access Token. Kein API Secret und kein Webhook Secret werden benötigt.
Access Token erstellen
- Öffne in Gumroad die Entwickler- oder API-Einstellungen deines Accounts.
- Erstelle oder kopiere einen Access Token für den Account, der die relevanten Produkte verkauft.
- Speichere den Token sicher. GramGrow benötigt keinen API Secret-Wert.
- Füge den Access Token in GramGrow unter Settings -> Payments ein und speichere die Zahlungseinstellungen.
Nur ein Credential
Webhooks und Resource Subscriptions
Gumroad-Webhooks werden in GramGrow tenant-spezifisch empfangen. Die technische URL hat die Form /webhooks/gumroad/:tenantId, du solltest sie aber aus GramGrow kopieren, damit Tenant und öffentliche Basis-URL stimmen.
Webhook-Validierung und Resource Subscriptions werden über Gumroad API-Callbacks gehandhabt. Wenn eine öffentliche API Base URL konfiguriert ist, registriert das Backend die Resource Subscriptions best-effort automatisch.
Gumroad webhook setup
URL: copied from GramGrow
Technical route: /webhooks/gumroad/:tenantId
Stored webhook secret: none
Events: sale, refund, dispute, dispute_won, cancellation, subscription_updated, subscription_ended, subscription_restartedFelder in GramGrow
| GramGrow-Feld | Was eintragen | Zweck |
|---|---|---|
| Access Token | Access Token aus Gumroad | Erforderlich für API-Lookups, Purchase Checker und Subscription-Registrierung. |
| API Secret | Leer lassen | Gumroad benötigt in GramGrow kein separates API Secret. |
| Webhook URL | Aus GramGrow kopieren | Tenant-spezifische Zieladresse für Gumroad-Callbacks. |
| Webhook Secret | Nicht speichern | GramGrow speichert für Gumroad kein Webhook Secret. |
Verbindung testen
Speichere den Gumroad Access Token in Settings -> Payments und führe danach den Verbindungstest aus. Ein erfolgreicher Test bedeutet: GramGrow kann Gumroad mit dem gespeicherten Access Token erreichen.
Expected setup result
Gumroad card: Connected
Access token: saved
API secret: empty
Webhook secret: not stored
Subscribed events: sale, refund, dispute, dispute_won, cancellation, subscription_updated, subscription_ended, subscription_restartedPurchase Checker
Nach erfolgreicher Verbindung kannst du im Purchase Checker eine Kunden-E-Mail prüfen. GramGrow fragt Gumroad Sales per E-Mail ab und schließt erstattete Verkäufe aus, damit Refunds nicht als gültiger Kaufnachweis zählen.
Fehlerbehebung
GramGrow fragt nach API Secret oder Webhook Secret
Für Gumroad leer lassen. GramGrow benötigt nur den Access Token und speichert kein Webhook Secret.
Verbindungstest schlägt fehl
Prüfe, ob der Access Token aus dem richtigen Gumroad-Account stammt und nicht abgeschnitten oder mit Leerzeichen eingefügt wurde.
Webhook-Ereignisse kommen nicht an
Kopiere die Webhook-URL erneut aus GramGrow. Die Route ist tenant-spezifisch und muss öffentlich erreichbar sein.
Resource Subscriptions werden nicht registriert
Prüfe, ob eine öffentliche API Base URL konfiguriert ist. Ohne öffentliche URL kann das Backend keine Gumroad-Callbacks registrieren.
Purchase Checker findet keinen gültigen Kauf
Prüfe die E-Mail-Adresse und ob der Verkauf erstattet wurde. Erstattete Verkäufe werden bewusst ausgeschlossen.