PayPal Kundenzahlungen einrichten
Diese Anleitung erklärt, wie du PayPal für API-basierte Kaufprüfung, signierte Webhooks und manuelle Zahlungsnachweise in GramGrow verbindest.
Wichtig
Was PayPal in GramGrow macht
GramGrow nutzt die hinterlegten PayPal-Credentials, um erfolgreiche Zahlungen einem Kontakt, einer Membership oder einem Access-Ziel zuzuordnen. Der API-Zugriff dient für manuelle Kaufprüfung und Support-Fälle. Der Webhook-Pfad liefert Zahlungsereignisse an GramGrow, sobald er vollständig konfiguriert ist.
Geeignet für
Kaufprüfung, Support-Fälle, Membership-Sync und manuelle Access-Entscheidungen.
Sicherheitsgrenze
Client Secret und Webhook ID sind vertraulich. Teile sie nicht in Tickets, Chats oder Screenshots.
REST-App und API-Credentials
- Öffne im PayPal Developer Dashboard den richtigen Live- oder Sandbox-Account.
- Erstelle eine REST-App oder öffne die REST-App, die zu deinem Shop oder Checkout gehört.
- Kopiere die Client ID und das Client Secret aus derselben Umgebung.
- Speichere beide Werte in GramGrow unter Settings -> Payments. Danach können API-Lookups ausgeführt werden.
Sandbox und Live nicht mischen
Webhook einrichten
PayPal-Webhooks in GramGrow sind tenant-spezifisch. Kopiere die Webhook URL deshalb direkt aus GramGrow, statt sie manuell zusammenzubauen. Die URL verwendet den Pfad /webhooks/paypal/:tenantId, aber GramGrow zeigt dir den passenden Wert für deinen Workspace an.
- Öffne die REST-App im PayPal Developer Dashboard.
- Erstelle unter Webhooks einen neuen Webhook.
- Füge die Webhook URL ein, die GramGrow in den Payment Settings anzeigt.
- Aktiviere Zahlungsereignisse, die erfolgreiche Zahlungen, Rückerstattungen und Zahlungsänderungen abdecken.
- Kopiere nach dem Speichern die Webhook ID und speichere sie in GramGrow.
PayPal webhook
URL: copy from GramGrow Payment Settings
Webhook ID: copy from PayPal after creating the webhook
Purpose: signature verification and full webhook automationFelder in GramGrow
| GramGrow-Feld | Was eintragen | Zweck |
|---|---|---|
| Client ID | Client ID der PayPal REST-App | Erforderlich für PayPal API-Lookups. |
| Client Secret | Client Secret derselben PayPal REST-App | Erforderlich für PayPal API-Lookups. |
| Webhook URL | Aus GramGrow kopieren | Tenant-spezifische Zieladresse für PayPal-Webhooks. |
| Webhook ID | Webhook ID aus der PayPal REST-App | Erforderlich für Signaturprüfung und vollständige Webhook-Automatisierung. |
Verbindung testen
Speichere zuerst Client ID und Client Secret in GramGrow. Ein erfolgreicher Re-check bedeutet: GramGrow kann PayPal authentifizieren und API-Lookups ausführen. Speichere danach die Webhook ID, damit PayPal-Ereignisse signiert geprüft und vollständig automatisiert verarbeitet werden können.
Expected setup result
PayPal card: Connected
Client ID: saved
Client Secret: saved
Webhook ID: saved for signature verificationPurchase Checker
Im Purchase Checker sucht GramGrow erfolgreiche PayPal-Transaktionen zur eingegebenen Payer-E-Mail. Dafür müssen Client ID und Client Secret gespeichert sein. Je nach PayPal-Konto kann Zugriff auf die Transaction Search API erforderlich sein, bevor PayPal die passenden Transaktionen zurückliefert.
Fehlerbehebung
Re-check bleibt rot
Prüfe, ob Client ID und Client Secret vollständig kopiert wurden und aus derselben Sandbox- oder Live-Umgebung stammen.
Purchase Checker findet keinen Kauf
Prüfe die Payer-E-Mail, den Zeitraum, die PayPal-Umgebung und ob dein PayPal-Konto Zugriff auf die Transaction Search API hat.
Webhook-Ereignisse werden abgelehnt
Vergleiche die in GramGrow gespeicherte Webhook ID mit der Webhook ID in derselben PayPal REST-App. Ohne korrekte Webhook ID kann GramGrow die Signatur nicht verifizieren.
Webhook URL ist unklar
Kopiere die URL direkt aus GramGrow. Sie ist tenant-spezifisch und sollte nicht manuell aus einem Beispiel zusammengesetzt werden.
Sandbox-Zahlungen erscheinen nicht
Nutze Sandbox-Credentials, eine Sandbox-Webhook ID und eine Sandbox-Transaktion mit derselben Payer-E-Mail.