Vollständige Liste der Webhook-Events
Wenn du die Automatisierung selbst übernimmst, kannst du das programmatisch oder mit Tools wie Zapier tun. Hinterlege die Webhook-URL in den Produkteinstellungen im Tab Integrations and webhook (Integrationen und Webhook). Nach dem Kauf schicken wir die Transaktionsdaten dorthin. Den Webhook erzeugst du zum Beispiel mit Zapier oder Make (früher Integromat).
Die wichtigsten Events, nach denen wir filtern, tragen den Event-Key und lauten:
- single_product_bought - Kauf eines einzelnen Produkts
- product_assigned - ein einzelnes Produkt wurde einem Nutzer erfolgreich zugewiesen
- product_access_expiring - der Zugang zu einem einzelnen Produkt läuft bald ab
- product_access_expired - der Zugang zu einem einzelnen Produkt ist abgelaufen
- subscription_created - Kauf eines neuen Abos
- subscription_plan_changed - Tarifwechsel über das Easycart-Panel
- subscription_canceled - Kündigung des Abos im Easycart-Panel (bleibt bis zum Ende der Abrechnungsperiode gültig)
- subscription_expired - endgültiger Ablauf des Abos
- subscription_renewed - Verlängerung des Abos
- subscription_renewal_failed - fehlgeschlagener Einzugsversuch für die Verlängerung
- subscription_renewal_upcoming - anstehende Verlängerung
- subscription_resumed - Abo erfolgreich fortgesetzt
- subscription_deleted - Abo wurde endgültig gelöscht
- customer_data_changed - Änderung der Kundendaten
Alle Fälle und die zugehörigen Webhook-Antworten findest du unten:
Webhook nach erfolgreichem Kauf eines einzelnen Produkts
Webhook nach erfolgreicher Zuweisung eines Produkts
Webhook, wenn der Zugang zu einem einzelnen Produkt abläuft
Webhook nach abgelaufenem Zugang zu einem einzelnen Produkt
Webhook nach erfolgreichem Abo-Kauf
Dieses Event senden wir nach dem Kauf eines Abos. Spätestens jetzt sollte der Zugang zum Produkt freigeschaltet werden. Wichtig: Das Abo kann im Testzeitraum starten. Dann gibt die Eigenschaft trial_ends_at das Enddatum an, andernfalls steht sie auf null.
Webhook nach Klick auf Switch to this plan im Abo-Panel
Der Kunde kann im Easycart-Panel zu einem anderen Tarif wechseln, sofern du einen definiert hast. Der an den Webhook übergebene Tarifname stammt von hier:
- Die Eigenschaft subscription_plan_name sagt dir, zu welchem Tarif der Nutzer gewechselt ist
- Die Eigenschaft subscription_plan_price nennt den aktuellen Preis
Webhook, nachdem der Nutzer im Abo-Panel auf Cancel klickt
Die Eigenschaft subscription_current_period_end nennt das Datum, an dem der Tarif deaktiviert werden soll (und damit der Zugang zum Produkt entzogen wird).
Webhook nach Ablauf des Abos
Dieses Event senden wir, wenn das Abo inaktiv wird - durch Kündigung des Kunden, manuelle Kündigung im Stripe-Panel oder weil die Zahlung mehrfach nicht eingezogen werden konnte. Jetzt sollte der Zugang zum Produkt deaktiviert werden.
Webhook nach erfolgreichem Einzug für die nächste Abrechnungsperiode
Nach dem Einzug der Gebühr für die Abrechnungsperiode senden wir ein Event mit folgenden Daten.
- Die Eigenschaft amount_paid ist der eingezogene Betrag - über diesen Betrag sollte die Rechnung ausgestellt werden
- Die Rechnungsdaten stehen in der Eigenschaft invoice_data (die null sein kann, wenn keine vorliegen)
Webhook bei fehlgeschlagenem Einzug für die nächste Abrechnungsperiode
Für den Fall, dass der Einzug für die Abrechnungsperiode fehlschlägt. Die Eigenschaft error_message enthält Informationen zum Fehler.
Webhook X Tage vor dem nächsten Einzug
X Tage vor dem nächsten Einzug senden wir folgende Daten an den Webhook. Die Eigenschaft subscription_renews_at nennt das Datum des nächsten Einzugs.
Der Webhook basiert auf dem Event invoice.upcoming von Stripe.
Webhook X Tage vor Ende des Testzeitraums
Der Webhook ist identisch mit dem obigen. Ist die Eigenschaft trial_ends_at aber nicht null, handelt es sich um den ersten Einzug. In Stripe legst du fest, wie viele Tage vor dem ersten Einzug der Kunde benachrichtigt wird. So geht es:
- Gehe zu den Einstellungen in Stripe
- Wähle im Bereich Prevent failed payments (Fehlgeschlagene Zahlungen vermeiden) die passende Anzahl Tage
