Webhooks einrichten

Einrichtung von Webhooks für Echtzeit-Zahlungsupdates

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

---

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 synchronisieren.

---

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 Online

• Webhooks funktionieren in der Regel automatisch

• Die URL wird von Microsoft gehostet

Für Business Central On-Premises

• Sie benötigen eine öffentliche IP-Adresse oder Domain

• Firewall muss eingehende Verbindungen auf dem entsprechenden Port erlauben

• HTTPS wird empfohlen (erforderlich für Mollie)

---

Webhooks aktivieren

Schritt 1: Webhook-Funktion aktivieren

1. Öffnen Sie Mollie Einrichtung

2. Navigieren Sie zum Bereich Webhooks

3. Aktivieren Sie "Webhooks aktivieren"

Schritt 2: Webhook-URL konfigurieren

1. Geben Sie Ihre Webhook URL ein

2. 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.

---

Webhook-URL Format

Die Webhook-URL folgt diesem Schema:

https://[Ihre BC URL]/api/solutioo/mollie/v1.0/webhook

Beispiel:

https://businesscentral.dynamics.com/abc123/api/solutioo/mollie/v1.0/webhook

---

Webhook-Ereignisse

Folgende Ereignisse lösen Webhook-Benachrichtigungen aus:

Ereignis	Beschreibung
payment.paid	Zahlung wurde erfolgreich durchgeführt
payment.expired	Zahlungslink ist abgelaufen
payment.canceled	Zahlung wurde vom Kunden abgebrochen
payment.failed	Zahlung ist fehlgeschlagen
refund.created	Erstattung wurde erstellt
refund.refunded	Erstattung wurde durchgeführt
chargeback.created	Rückbuchung wurde eingeleitet

---

Webhook-Log überwachen

Alle eingehenden Webhooks werden protokolliert:

1. Öffnen Sie Mollie Einrichtung

2. Klicken Sie auf "Webhook-Log"

3. Sehen Sie alle empfangenen Webhooks mit Zeitstempel und Payload

Webhook-Log

---

Fehlerbehebung

Webhooks kommen nicht an

1. Prüfen Sie, ob die Webhook-URL öffentlich erreichbar ist

2. Stellen Sie sicher, dass HTTPS konfiguriert ist

3. Überprüfen Sie Ihre Firewall-Einstellungen

4. Prüfen Sie das Webhook-Log auf Fehlermeldungen

Webhooks werden verzögert empfangen

• Mollie versucht die Zustellung mehrfach

• Bei temporären Problemen werden Webhooks erneut gesendet

Webhook-Probleme