Was Sie brauchen
| Feld | Was es tut |
|---|---|
| Client ID | Identifiziert Ihre PayPal-App bei API-Aufrufen. Mit dem Secret gepaart. |
| Client Secret | Die geheime Hälfte der API-Authentifizierung. Mit der Client ID erstellt es die Bestellung. Geheim. |
| Webhook ID | Identifiziert den Webhook, den PayPal signiert, sodass wir jede Zustellung verifizieren können. |
| Erfolgs-URL / Abbruch-URL | Wohin der Käufer nach dem Zahlen oder Abbrechen landet. |
Warum wir nach jedem Feld fragen
Client ID
Identifiziert Ihre PayPal-App bei API-Aufrufen. Sie funktioniert nur, wenn sie mit dem Client Secret gepaart ist.
Client Secret
Die private Hälfte der API-Authentifizierung. Mit der Client ID lässt es uns die Bestellung erstellen, sodass die Zahlung über Ihr Konto läuft.
Webhook ID
Wie wir bestätigen, dass ein Webhook echt von PayPal stammt: PayPal kennzeichnet jeden Webhook mit einer ID, und wir nutzen sie, um PayPal direkt zu fragen, ob eine bestimmte Nachricht echt ist. Das hindert jeden daran, ein "bezahlt"-Ereignis zu fälschen.
Erfolgs- und Abbruch-URL
Schlichte Einstellungen: wohin der Käufer nach dem Zahlen oder Abbrechen landet. Nicht geheim.
Einrichten
- PayPal-Entwickler-Dashboard öffnen
Melden Sie sich bei developer.paypal.com an. PayPal stellt Ihnen kostenlos einen Sandbox mit fiktiven Geschäfts- und Käuferkonten bereit, sodass Sie ohne echtes Geld testen können. Diese Anleitung führt durch den Sandbox; der Live-Ablauf ist identisch, drehen Sie einfach den Sandbox/Live-Schalter (oben links) um und verwenden Sie ein PayPal-Geschäftskonto. Öffnen Sie vom Dashboard aus Apps & Credentials.
PayPal Developer → Apps & Credentials - Eine App erstellen
Vergewissern Sie sich auf der API-Credentials-Seite, dass der Sandbox-Schalter ausgewählt ist, und klicken Sie dann auf Create App (oben rechts).
PayPal → Apps & Credentials → Create App - Benennen und Merchant wählen
Geben Sie einen App-Namen ein (zum Beispiel „Coin Moebius"), belassen Sie den Type auf Merchant, wählen Sie Ihr Sandbox-Geschäftskonto und klicken Sie Create App.
PayPal → Create App - Client ID und Client Secret kopieren
PayPal öffnet Ihre neue App. Kopieren Sie die Client ID und enthüllen und kopieren Sie den Secret key. (Beide können Sie auch aus der Zeile „Default Application" in der API-Credentials-Liste kopieren.) Legen Sie sie beiseite.
1. PayPal → API Credentials → Ihre App in der Liste 2. PayPal → Ihre App → Client ID und Secret Das Client Secret ist geheim, behandeln Sie es wie ein Passwort. Die Sandbox-App und die Live-App haben jeweils ein eigenes Paar, mischen Sie sie also nicht.
- Einen Webhook hinzufügen
Scrollen Sie auf der App-Seite nach unten zum Abschnitt „Sandbox Webhooks" und klicken Sie Add Webhook. Fügen Sie im Feld Webhook URL die PayPal-Webhook-Adresse Ihres Projekts ein (unten). Wählen Sie dann die Ereignisse aus, auf die Coin Moebius hört, und klicken Sie Speichern.
- Einmalzahlungen: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
- Abos (nur wenn Sie diese verkaufen): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Wenn Sie nicht auf Abonnementbasis abrechnen, lassen Sie diese weg.
- In Eile? Auch die Auswahl von All Events (der Platzhalter ganz oben) funktioniert, wir ignorieren alles, was wir nicht verwenden.
https://api.coinmoebius.com/webhook/paypal/<your project id>PayPal → Ihre App → Add webhook Ihre Projekt-ID steht im Coin Moebius Dashboard unter dem Projektnamen; tragen Sie sie in die obige Adresse ein. Die verbundene Anbieterkarte (letzter Schritt) zeigt dieselbe URL als Referenz.
- Webhook ID kopieren
Ihr Webhook erscheint nun in der Liste „Sandbox Webhooks". Kopieren Sie die daneben angezeigte Webhook ID. So fragt Coin Moebius PayPal, ob jeder Webhook echt ist. Registrieren Sie in Sandbox und in Live jeweils einen separaten Webhook.
PayPal → Ihre App → Sandbox Webhooks → Webhook ID - Zurück in Coin Moebius: Anbieter hinzufügen → PayPal
Öffnen Sie in Ihrem Projekt den Reiter Anbieter, klicken Sie Anbieter hinzufügen, wählen Sie Dienst verbinden und dann PayPal. Legen Sie Ihre Erfolgs-URL und Abbruch-URL fest. Möchten Sie mit Sandbox-Zugangsdaten testen? Verwenden Sie den Reiter Test (optional) und fügen Sie dort Ihre Client ID, Ihr Client Secret und die Webhook ID ein, und klicken Sie dann auf Speichern. Gehen Sie direkt live? Verwenden Sie den Live-Reiter. Die Test-Gruppe ist ganz oder gar nicht: alle drei Felder, oder keines.
Coin Moebius → Anbieter hinzufügen → PayPal - Sie sind verbunden
PayPal erscheint jetzt im Reiter Anbieter mit dem Verbindungsdatum (als TEST gekennzeichnet, wenn Sie Sandbox-Zugangsdaten verwendet haben). Die Karte zeigt dieselbe Webhook-URL, die Sie in PayPal eingefügt haben, sowie Bearbeiten und Trennen.
Coin Moebius → Anbieter → PayPal (verbunden) - Mit einem Sandbox-Käufer testen
Um einen Test-Checkout zu bezahlen, benötigen Sie Ihre Sandbox-Käufer-Anmeldedaten. Öffnen Sie in PayPal Testing Tools → Sandbox Accounts, um Ihre fiktiven Geschäfts- und Privatkonten zu sehen.
PayPal → Testing Tools → Sandbox Accounts - Käufer-Anmeldedaten abrufen
Öffnen Sie das Privat-(Käufer-)Konto, um seine Login-Informationen anzuzeigen: Sandbox-URL, E-Mail und Passwort. Melden Sie sich unter sandbox.paypal.com mit diesen Daten an, wenn ein Test-Checkout Sie zur Zahlung auffordert. Es wird kein echtes Geld bewegt.
PayPal → Sandbox-Konto → Login Info
Nachdem Sie verbunden haben
Führen Sie vor dem Live-Gang eine Testzahlung durch:
- Erstellen Sie ein Produkt und setzen Sie seine Umgebung auf Testing. Das betreibt das Produkt mit Ihren Sandbox-Zugangsdaten, sodass Sie eine volle Bestellung aufgeben können, ohne Geld zu bewegen. (Wenn Sie den Sandbox-Satz übersprungen haben, fällt ein Testing-Produkt auf Live zurück, fügen Sie ihn also zuerst hinzu.)
- Setzen Sie den Buy-Button auf eine Seite (eine lokale HTML-Datei reicht), die auf Ihr Projekt zeigt.
- Schließen Sie den Checkout ab, indem Sie mit Ihrem Sandbox-Käuferkonto zahlen.
- Öffnen Sie den Reiter Transaktionen. Eine neue Zeile erscheint, mit Testing markiert. Wenn ihr Status succeeded erreicht, funktionieren Ihre Zugangsdaten und der Webhook beide von Ende zu Ende.
Schalten Sie die Umgebung des Produkts auf Live, wenn Sie für echte Zahlungen bereit sind.
Fehlerbehebung
Beginnen Sie mit Verifizieren. Klicken Sie im Dashboard Verifizieren (oder Testdaten verifizieren für Sandbox), um Ihre Client-Zugangsdaten zu prüfen.
Verifizieren schlägt fehl.
Kopieren Sie die Client ID und das Client Secret erneut. Die Sandbox-App und die Live-App haben verschiedene Paare, mischen Sie sie also nicht.
Zahlung wird abgeschlossen, aber die Bestellung bleibt ausstehend.
Die Webhook ID muss aus derselben App und Umgebung wie Ihre Client-Zugangsdaten stammen. Live-Zugangsdaten brauchen die Live-Webhook-ID. Bestätigen Sie, dass die Webhook-URL übereinstimmt.
Bestätigen Sie es von Ende zu Ende.
PayPal Developer Dashboard → Webhooks Simulator: senden Sie ein Beispielereignis an Ihre Webhook-URL und beobachten Sie, wie die Bestellung sich aktualisiert.
Gut zu wissen
Secrets rotieren. Erzeugen Sie jederzeit ein neues Client Secret, fügen Sie es dann ein. Geheime Felder bleiben beim Bearbeiten leer.
Fragen? Join our Discord