Einrichtung Webhooks und Webhook-Log

Einrichtung von Webhooks für Echtzeit-Zahlungsupdates

Webhooks ermöglichen es Mollie, Ihr Business Central automatisch über Zahlungsänderungen zu informieren.

1. Was sind Webhooks?

Webhooks sind automatische Benachrichtigungen, die Mollie an Ihr System sendet, wenn sich der Status einer Zahlung ändert:

• Kunde hat bezahlt
• Zahlung ist abgelaufen
• Erstattung wurde durchgeführt
• Rückbuchung eingegangen

Ohne Webhooks müssen Sie den Zahlungsstatus manuell abfragen oder über Aufgabenwarteschlangen synchronisieren.

---

2. Voraussetzungen

Wichtig: Für Webhooks benötigen Sie eine öffentlich erreichbare URL. Ihr Business Central muss aus dem Internet erreichbar sein.

Für Business Central 365 (Cloud)

• Webhooks funktionieren in der Regel automatisch.
• Die URL wird von Microsoft gehostet.

---

3. Webhooks aktivieren

1

Webhook-Funktion aktivieren

• Öffnen Sie "Mollie Setup".
• Navigieren Sie zum Bereich Webhooks.
• Aktivieren Sie "Webhooks aktivieren".

2

Webhook-URL konfigurieren

• Geben Sie Ihre "Webhook URL" ein.
• Format: https://ihre-domain.de/api/mollie/webhook

Die genaue URL hängt von Ihrer Business Central Konfiguration ab. Kontaktieren Sie bei Bedarf Ihren Systemadministrator.

---

4. Webhook-Log

Webhook-Aktivitäten überwachen und analysieren.

Das Webhook-Log protokolliert alle eingehenden Benachrichtigungen von Mollie.

4.1 Webhook-Log öffnen

Über die Suche

Suchen Sie nach "Mollie Webhook-Log" und die Liste aller Webhooks wird angezeigt.

Über die Mollie Einrichtung

Öffnen Sie "Mollie Einrichtung" / "Mollie Setup" und klicken Sie auf "Webhook-Log".

Über das Dashboard

Öffnen Sie das "Mollie Dashboard" und klicken Sie auf "Webhook-Log".

4.2 Protokollierte Informationen

• Eintragsnr. (Eindeutige Nummer des Eintrags)
• Zeitstempel (Wann der Webhook empfangen wurde)
• Ereignis-Typ (Art des Ereignisses)
• Payment ID (Betroffene Zahlungs-ID)
• Status (Verarbeitungsstatus)
• Payload (Empfangene Daten (JSON))

4.3 Filterung

Nach Zeitraum	Nach Status	Nach Payment ID
Klicken Sie auf die Spalte "Zeitstempel" und wählen Sie den gewünschten Zeitraum.	Klicken Sie auf die Spalte "Status" und filtern Sie nach "Failed" um Probleme zu finden.	Klicken Sie auf die Spalte "Payment ID" und geben Sie die gesuchte ID ein.

Debugging: Das Webhook-Log ist Ihr wichtigstes Werkzeug zur Fehlersuche bei Statusupdates.

4.4 Datenaufbewahrung

• Log-Einträge werden dauerhaft gespeichert.
• Bei sehr vielen Einträgen kann die Liste lang werden.
• Erwägen Sie eine regelmäßige Bereinigung alter Einträge.

Webhooks werden pro Zahlung konfiguriert, nicht global in Mollie. Die URL wird beim Erstellen des Zahlungslinks mitgesendet.

Sie müssen Webhooks nicht manuell in Mollie konfigurieren. Die Mollie Integration sendet die Webhook-URL automatisch.