---
title: "Webhooks einbinden"
canonical: "https://payactive.refined.site/space/PAYAC/1001095268/Webhooks%20einbinden"
format: markdown
---
> Macro (include)

**Webhooks einrichten**

Mit Webhooks können Sie Ihr System automatisiert über bestimmte Ereignisse im Payactive-Zahlungsprozess informieren lassen – in Echtzeit. So lassen sich externe Systeme effizient anbinden, etwa für Buchhaltung, Bestellabwicklung oder interne Statusupdates.

---

**🔧 Voraussetzungen**

Um einen Webhook bei Payactive zu erstellen, benötigen Sie:

- Eine gültige Ziel-URL (Ihr Endpoint, der Anfragen empfangen kann)
- Einen eindeutigen Namen für den Webhook
- Die Auswahl, welche Events Sie empfangen möchten

---

**📝 Webhook anlegen – Schritt für Schritt**

1. Navigieren Sie im Payactive-Portal zum Bereich *„Webhook-Endpunkte“*.
2. Klicken Sie auf *„Neuen Webhook-Endpunkt hinzufügen“*.
3. Geben Sie unter **URL** die Adresse ein, an die die Webhook-Nachrichten gesendet werden sollen.
4. Vergeben Sie unter **Name** eine klare Bezeichnung (z. B. „Webhook Bestellstatus“).
5. Wählen Sie die gewünschten Events aus der Liste aus (siehe unten).
6. Speichern Sie den Webhook.

---

**📬 Verfügbare Events**

Sie können bis zu fünf Events aktivieren. Sobald eines dieser Ereignisse im System eintritt, wird automatisch eine Benachrichtigung an Ihre URL gesendet.

- **Zahlung ausgelöst** – `payment.initiated`  
Wird gesendet, sobald eine neue Zahlung gestartet wurde (z. B. durch Klick auf „Zahlung ausführen“).
- **Zahlung eingegangen** – `payment.settled`  
Wird gesendet, sobald die Zahlung erfolgreich abgeschlossen und verbucht wurde.
- **Zahlung fehlgeschlagen** – `payment.failed`  
Wird gesendet, wenn die Zahlung aufgrund eines Fehlers oder Abbruchs nicht abgeschlossen werden konnte.
- **Check-out ausgelöst** – `checkout.initiated`  
Wird gesendet, wenn der Bezahlprozess im Checkout begonnen wurde (z. B. bei Anzeige der Zahlungsoptionen).
- **Check-out abgeschlossen** – `checkout.completed`  
Wird gesendet, wenn der Bezahlprozess abgeschlossen wurde – unabhängig vom Ausgang der Zahlung.

---

**🔐 Sicherheit & Hinweise**

- Achten Sie darauf, dass Ihr Webhook-Endpunkt HTTPS unterstützt und eingehende Daten validieren kann.
- Payactive sendet standardisierte JSON-Nachrichten an Ihre URL.
- Stellen Sie sicher, dass Ihr Server Webhook-Nachrichten zuverlässig empfängt und verarbeitet (Statuscode 2xx).
- Webhooks können jederzeit im Portal deaktiviert oder bearbeitet werden.

---

**📎 Typische Anwendungsfälle**

- Automatisches Aktualisieren von Bestellstatus in Ihrem Shop
- Buchhalterische Erfassung eingegangener Zahlungen
- Benachrichtigungssysteme bei fehlgeschlagenen Zahlungen
- Trigger für den Versand nach Zahlungseingang



> Macro (include)