Webhook-Integration
Die Webhook-Integration funktioniert mit jedem Zahlungsanbieter, der HTTP-Requests senden kann. Du bekommst eine eindeutige URL, konfigurierst sie bei deinem Zahlungsanbieter, und Käufe schreiben Teilnehmer automatisch ein.
Einrichtung
- Gehe zu Einstellungen → Integrationen → Integration hinzufügen → Webhook
- Gib ein Label ein (z.B. „Gumroad" oder „Stripe"), um den Webhook zu identifizieren
- Kopiere die generierte Webhook-URL
- Füge die URL in die Webhook-Einstellungen deines Zahlungsanbieters ein
Der Webhook ist sofort aktiv.
So funktioniert's
Wenn ein Kauf stattfindet, sendet dein Zahlungsanbieter einen POST-Request an die Webhook-URL mit den Teilnehmer-Informationen. Simplecourse erstellt das Teilnehmerkonto und schreibt ihn in den Kurs ein.
Da die Kurs-ID im Payload enthalten ist, musst du keine Zugangsquelle in Simplecourse hinzufügen — der Webhook definiert bereits, für welchen Kurs der Zugang gilt.
Konfiguration
Dein Zahlungsanbieter muss einen JSON-POST-Request an die Webhook-URL senden. Wie genau du das einrichtest, hängt von deinem Anbieter ab — schau in dessen Webhook-Dokumentation für Details. Hier ist, was Simplecourse erwartet:
| Feld | Pflicht | Beschreibung |
|---|---|---|
email |
Ja | E-Mail-Adresse des Teilnehmers |
course_id |
Ja | Die Kurs-ID (angezeigt im Zugang-Tab) |
tier |
Nein | Zugangslevel: 1, 2 oder 3 (Standard: 1) |
first_name |
Nein | Vorname des Teilnehmers |
last_name |
Nein | Nachname des Teilnehmers |
Beispiel:
{
"email": "[email protected]",
"course_id": 42,
"tier": 1,
"first_name": "Max",
"last_name": "Mustermann"
}
Antwort-Codes
| Code | Bedeutung |
|---|---|
| 201 | Teilnehmer hat Zugang erhalten |
| 200 | Teilnehmer hatte bereits Zugang |
| 400 | Ungültiger Request (fehlende Felder oder fehlerhafte Daten) |
| 401 | Ungültiger oder inaktiver Webhook |
| 404 | Kurs nicht gefunden |
Sicherheit
Die Webhook-URL enthält ein einzigartiges Geheimnis — jeder mit der URL kann Zugang auslösen. Halte sie privat und teile sie nur mit deinem Zahlungsanbieter. Wenn du vermutest, dass sie kompromittiert wurde, lösche den Webhook und erstelle einen neuen.