# Einrichtung Webhooks und Webhook-Log

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

{% hint style="warning" %}
**Wichtig:** Für Webhooks benötigen Sie eine öffentlich erreichbare URL. Ihr Business Central muss aus dem Internet erreichbar sein.
{% endhint %}

#### Für Business Central 365 (Cloud)

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

***

## 3. Webhooks aktivieren

{% stepper %}
{% step %}

### Webhook-Funktion aktivieren

* Öffnen Sie *"Mollie Setup".*
* Navigieren Sie zum Bereich *Webhooks***.**
* Aktivieren Sie *"Webhooks aktivieren".*
  {% endstep %}

{% step %}

### Webhook-URL konfigurieren

* Geben Sie Ihre *"Webhook URL"* ein.
* Format: `https://ihre-domain.de/api/mollie/webhook`
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
Die genaue URL hängt von Ihrer Business Central Konfiguration ab. Kontaktieren Sie bei Bedarf Ihren Systemadministrator.
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://1855875201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fuavme8c9AG1nZnBMERrf%2Fuploads%2FYUDYVZDCei3s6M0PKbvz%2Fwebhooks.png?alt=media&#x26;token=6f9c968f-0b14-499b-9b6e-22517e9bed05" alt="" width="563"><figcaption></figcaption></figure></div>

***

## 4. Webhook-Log

Webhook-Aktivitäten überwachen und analysieren.

Das Webhook-Log protokolliert alle eingehenden Benachrichtigungen von Mollie.

### 4.1 Webhook-Log öffnen

{% tabs %}
{% tab title="Über die Suche" %}
Suchen Sie nach *"Mollie Webhook-Log"* und die Liste aller Webhooks wird angezeigt.
{% endtab %}

{% tab title="Über die Mollie Einrichtung" %}
Öffnen Sie "*Mollie Einrichtung" /* "Mollie Setup" und klicken Sie auf *"Webhook-Log".*
{% endtab %}

{% tab title="Über das Dashboard" %}
Öffnen Sie das *"Mollie Dashboard"* und klicken Sie auf *"Webhook-Log".*
{% endtab %}
{% endtabs %}

### 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

<table><thead><tr><th width="253.5811767578125">Nach Zeitraum</th><th width="276.5433349609375">Nach Status</th><th>Nach Payment ID</th></tr></thead><tbody><tr><td>Klicken Sie auf die Spalte <em>"Zeitstempel"</em> und wählen Sie den gewünschten Zeitraum.</td><td>Klicken Sie auf die Spalte <em>"Status"</em> und filtern Sie nach "Failed" um Probleme zu finden.</td><td>Klicken Sie auf die Spalte <em>"Payment ID"</em> und geben Sie die gesuchte ID ein.</td></tr></tbody></table>

{% hint style="info" %}
**Debugging:** Das Webhook-Log ist Ihr wichtigstes Werkzeug zur Fehlersuche bei Statusupdates.
{% endhint %}

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

{% hint style="info" %}
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.
{% endhint %}