# Häufige Fragen

### Allgemein

<details>

<summary><strong>Brauchen Sie ein Mollie Konto?</strong></summary>

**Ja.** Sie benötigen ein aktives Mollie-Konto, um die Integration nutzen zu können. Die Registrierung ist kostenlos.

[Mollie-Konto erstellen](/mollie-integration/erste-schritte/mollie-konto-erstellen.md)

</details>

<details>

<summary><strong>Was kostet die Mollie Integration?</strong></summary>

Die Mollie Integration wird über Microsoft AppSource lizenziert. Die aktuellen Preise finden Sie dort oder kontaktieren Sie unser Vertriebsteam.

**Zusätzlich fallen Mollie-Transaktionsgebühren an** – diese sind unabhängig von der Integration und werden direkt von Mollie berechnet.

</details>

<details>

<summary><strong>Funktioniert die Integration mit Business Central Online und On-Premises?</strong></summary>

**Ja**, die Integration funktioniert mit beiden Varianten:

* **Online:** Vollständige Funktionalität out-of-the-box
* **On-Premises:** Zusätzliche Konfiguration für Webhooks erforderlich

</details>

<details>

<summary><strong>In welchen Sprachen ist die Integration verfügbar?</strong></summary>

Die Mollie Integration ist verfügbar in:

* **Deutsch (DE-DE)**
* **Englisch (EN-US)**

</details>

<details>

<summary><strong>Braucht jeder Mitarbeiter eine Lizenz für die Mollie Integration?</strong></summary>

Nein, es benötigen nur die Mitarbeiter eine Lizenz, die aktiv mit der Mollie Integration arbeiten werden. Also zum Beispiel Zahlungsstaus einsehen oder Zahlungslinks erstellen möchten.

</details>

### **Verbindungsprobleme**

<details>

<summary><strong>"Verbindung fehlgeschlagen" bei Test</strong></summary>

#### Symptom

Beim Klicken auf "Verbindung testen" erscheint:

> "Verbindung fehlgeschlagen. Bitte überprüfen Sie Ihren API-Key."

#### Mögliche Ursachen und Lösungen

#### 1. API-Key ist falsch

**Prüfung:**

* Kopieren Sie den API-Key erneut aus dem Mollie Dashboard
* Achten Sie auf vollständige Kopie (keine fehlenden Zeichen)
* Prüfen Sie auf versehentliche Leerzeichen

**Lösung:**

1. Melden Sie sich bei [my.mollie.com](https://my.mollie.com) an
2. Gehen Sie zu **Entwickler** → **API-Keys**
3. Kopieren Sie den Key vollständig
4. Fügen Sie ihn in Business Central ein

#### 2. API-Key wurde deaktiviert

**Prüfung:**

* Prüfen Sie im Mollie Dashboard, ob der Key aktiv ist

**Lösung:**

1. Erstellen Sie ggf. einen neuen API-Key in Mollie
2. Aktualisieren Sie den Key in Business Central

#### 3. Falscher Key-Typ

**Prüfung:**

* Test-Key (`test_...`) funktioniert nur für Testzahlungen
* Live-Key (`live_...`) funktioniert nur bei verifiziertem Konto

**Lösung:**

* Für Tests: Verwenden Sie den Test-Key
* Für Produktion: Verwenden Sie den Live-Key nach Verifizierung

#### 4. Netzwerkprobleme

**Prüfung:**

* Kann Ihr Business Central die Mollie-API erreichen?
* Firewall- oder Proxy-Einstellungen?

**Lösung:**

* Kontaktieren Sie Ihren IT-Administrator
* Mollie-API muss von BC erreichbar sein: `api.mollie.com`

</details>

<details>

<summary><strong>Keine Antwort von der API</strong></summary>

Aktionen dauern sehr lange und enden mit Timeout.

#### Lösungen

1. **Netzwerkstatus prüfen**
   * Ist Ihre Internetverbindung stabil?
   * Gibt es Firewall-Beschränkungen?
2. **Mollie Status prüfen**
   * Besuchen Sie [status.mollie.com](https://status.mollie.com)
   * Prüfen Sie, ob es aktuelle Störungen gibt
3. **Später erneut versuchen**
   * Temporäre Netzwerkprobleme lösen sich oft von selbst

</details>

<details>

<summary><strong>API-Fehler in Aktionen</strong></summary>

#### "Unauthorized" (401)

**Bedeutung:** API-Key ist ungültig

**Lösung:**

* API-Key prüfen und neu eingeben

#### "Not Found" (404)

**Bedeutung:** Angefragte Ressource existiert nicht

**Lösung:**

* Prüfen Sie, ob die Payment ID korrekt ist
* Wurde die Zahlung möglicherweise gelöscht?

#### "Unprocessable Entity" (422)

**Bedeutung:** Daten sind ungültig

**Lösung:**

* Prüfen Sie die eingegebenen Daten (Betrag, Währung, etc.)
* Mindest-/Höchstbeträge beachten

#### "Too Many Requests" (429)

**Bedeutung:** Rate Limit erreicht

**Lösung:**

* Warten Sie einige Minuten
* Reduzieren Sie die Anzahl der Anfragen

#### "Internal Server Error" (500)

**Bedeutung:** Fehler auf Mollie-Seite

**Lösung:**

* Prüfen Sie [status.mollie.com](https://status.mollie.com)
* Später erneut versuchen
* Bei anhaltendem Problem: Mollie Support kontaktieren

</details>

<details>

<summary><strong>Checkliste bei Verbindungsproblemen</strong></summary>

* [ ] API-Key korrekt eingegeben?
* [ ] Richtiger Key-Typ (Test/Live)?
* [ ] Mollie-Konto verifiziert (für Live)?
* [ ] Netzwerkverbindung vorhanden?
* [ ] Firewall erlaubt Zugriff auf api.mollie.com?
* [ ] Mollie Status OK? ([status.mollie.com](https://status.mollie.com))

</details>

### Webhook-Probleme

<details>

<summary><strong>Webhooks kommen nicht an</strong></summary>

#### Symptom

* Zahlungsstatus wird nicht automatisch aktualisiert
* Webhook-Log zeigt keine neuen Einträge
* Nach Zahlung bleibt Status auf "Open" oder "Pending"

#### Prüfung

1. **Webhooks aktiviert?**
   * Öffnen Sie **Mollie Einrichtung**
   * Prüfen Sie: **"Webhooks aktivieren"** = Ja
2. **Webhook-URL konfiguriert?**
   * Prüfen Sie das Feld **"Webhook URL"**
   * URL muss vollständig und korrekt sein
3. **URL erreichbar?**
   * Die URL muss öffentlich aus dem Internet erreichbar sein
   * HTTPS ist erforderlich

#### Lösungen

#### URL nicht öffentlich erreichbar

**Business Central Online:**

* Prüfen Sie die korrekte Tenant-URL
* Kontaktieren Sie Microsoft Support bei Problemen

**Business Central On-Premises:**

* Konfigurieren Sie Port-Forwarding oder Reverse Proxy
* Stellen Sie sicher, dass HTTPS eingerichtet ist
* Firewall muss eingehende Verbindungen erlauben

#### URL-Format prüfen

Die URL sollte diesem Format entsprechen:

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

</details>

<details>

<summary><strong>Webhooks im Log, aber nicht verarbeitet</strong></summary>

#### Symptom

* Einträge im Webhook-Log vorhanden
* Status: "Failed" oder "Ignored"
* Zahlungsstatus nicht aktualisiert

#### Prüfung und Lösung

#### Status: Failed

Öffnen Sie den Log-Eintrag und prüfen Sie die Fehlermeldung:

| Fehler              | Lösung                           |
| ------------------- | -------------------------------- |
| "Payment not found" | Payment ID existiert nicht in BC |
| "Invalid payload"   | Daten von Mollie fehlerhaft      |
| "Database error"    | BC-Datenbankproblem              |

#### Status: Ignored

Der Webhook wurde absichtlich ignoriert:

* Doppelter Webhook (bereits verarbeitet)
* Unbekannter Ereignis-Typ
* Keine Aktion erforderlich

</details>

<details>

<summary><strong>Webhooks verzögert</strong></summary>

#### Symptom

* Webhooks kommen an, aber mit Verzögerung
* Status-Updates nicht in Echtzeit

#### Mögliche Ursachen

1. **Netzwerk-Latenz**
   * Normale Verzögerungen von wenigen Sekunden sind üblich
2. **Mollie-Wiederholungen**
   * Bei fehlgeschlagener Zustellung versucht Mollie es erneut
   * Das kann zu Verzögerungen führen
3. **Server-Auslastung**
   * Hohe Last kann Verarbeitung verzögern

#### Lösungen

* Prüfen Sie die Server-Performance
* Stellen Sie zuverlässige Erreichbarkeit sicher
* Bei anhaltenden Verzögerungen: Support kontaktieren

</details>

<details>

<summary><strong>Webhook-URL testen</strong></summary>

#### Manueller Test

1. Öffnen Sie eine Rechnung mit Zahlungslink
2. Führen Sie eine Testzahlung durch (Test-API-Key!)
3. Prüfen Sie das Webhook-Log auf Einträge

#### Erwartetes Ergebnis

* Neuer Eintrag im Webhook-Log
* Status: "Processed"
* Zahlungsstatus der Rechnung aktualisiert

</details>

<details>

<summary><strong>Status: Failed</strong></summary>

1. Öffnen Sie den Eintrag.
2. Prüfen Sie die Fehlermeldung.
3. Häufige Ursachen:
   * Ungültige Payment ID
   * Datenbank-Fehler
   * Berechtigungsprobleme

</details>

<details>

<summary><strong>Status: Ignored</strong></summary>

1. Der Webhook wurde absichtlich ignoriert.
2. Mögliche Gründe:
   * Doppelter Webhook
   * Unbekannter Ereignis-Typ
   * Bereits verarbeitet

</details>

<details>

<summary><strong>Checkliste Webhook-Probleme</strong></summary>

* [ ] Webhooks in BC aktiviert?
* [ ] Webhook-URL korrekt konfiguriert?
* [ ] URL öffentlich erreichbar?
* [ ] HTTPS eingerichtet?
* [ ] Firewall erlaubt eingehende Verbindungen?
* [ ] BC-Server läuft und ist erreichbar?
* [ ] Webhook-Log auf Fehler geprüft?

</details>

### Zahlungen

<details>

<summary><strong>Wie lange ist ein Zahlungslink gültig?</strong></summary>

Die Standard-Gültigkeit wird von Mollie festgelegt (typisch: 15 Minuten bis mehrere Tage, abhängig von der Zahlungsmethode).

</details>

<details>

<summary><strong>Kann ich den Betrag eines Zahlungslinks nachträglich ändern?</strong></summary>

**Nein.** Zahlungslinks können nach der Erstellung nicht geändert werden. Bei Betragsänderungen müssen Sie einen neuen Link erstellen.

</details>

<details>

<summary><strong>Kann ein Kunde mehrfach über denselben Link bezahlen?</strong></summary>

**Nein.** Ein Zahlungslink ist für eine einmalige Zahlung vorgesehen. Nach erfolgreicher Zahlung ist der Link nicht mehr verwendbar.

</details>

<details>

<summary><strong>Welche Zahlungsmethoden werden unterstützt?</strong></summary>

Alle von Mollie angebotenen Zahlungsmethoden:

* Kreditkarte (Visa, Mastercard, AmEx)
* PayPal
* iDEAL
* SEPA-Lastschrift
* Klarna
* SOFORT
* Giropay
* Bancontact
* und viele weitere...

Die verfügbaren Methoden hängen von Ihrer Mollie-Konfiguration ab.

</details>

<details>

<summary><strong>Buchungsblatt nicht gefunden</strong></summary>

**Ursache:** Konfiguriertes Journal existiert nicht

**Lösung:**

1. Öffnen Sie **Mollie Einrichtung**
2. Prüfen Sie **Buchungsblattvorlage** und **Buchungsblattstapel**
3. Stellen Sie sicher, dass diese existieren

</details>

<details>

<summary><strong>Ausgleichskonto nicht konfiguriert</strong></summary>

**Ursache:** Ausgleichskonto nicht eingerichtet

**Lösung:**

1. Öffnen Sie **Mollie Einrichtung**
2. Konfigurieren Sie **Ausgleichskontoart** und **Ausgleichskontonr.**

</details>

<details>

<summary><strong>Rechnung bereits ausgeglichen</strong></summary>

**Ursache:** Der offene Posten wurde bereits anderweitig ausgeglichen

**Lösung:**

* Keine Aktion erforderlich – Zahlung wurde bereits verarbeitet

</details>

<details>

<summary><strong>Betrag stimmt nicht überein</strong></summary>

**Ursache:** Zahlungsbetrag weicht von Rechnungsbetrag ab

**Lösung:**

* Prüfen Sie Teilzahlungen oder Währungsumrechnung
* Manuelle Anpassung kann erforderlich sein

</details>

<details>

<summary><strong>QR-Code wird auf Rechnungen nicht angezeigt</strong></summary>

* Prüfen Sie, ob ein Zahlungslink erstellt wurde
* Stellen Sie sicher, dass der Link erfolgreich generiert wurde
* Überprüfen Sie die Report-Konfiguration

</details>

<details>

<summary><strong>QR-Code lässt sich nicht scannen</strong></summary>

* Prüfen Sie die Druckqualität
* Erhöhen Sie die QR-Code-Größe
* Stellen Sie ausreichend Kontrast sicher

</details>

<details>

<summary><strong>Status aktualisiert sich nicht</strong></summary>

* Prüfen Sie die API-Verbindung (Verbindung testen)
* Überprüfen Sie den API-Key
* Kontrollieren Sie das Webhook-Log auf Fehler

</details>

<details>

<summary><strong>Unterschiedlicher Status in BC und Mollie</strong></summary>

1. Führen Sie eine manuelle Statusaktualisierung durch
2. Prüfen Sie, ob Webhooks korrekt ankommen
3. Bei Persistenz: Kontaktieren Sie den Support

</details>

<details>

<summary><strong>QR-Code wird nicht angezeigt</strong></summary>

* Prüfen Sie, ob ein Zahlungslink erstellt wurde
* Stellen Sie sicher, dass der Link erfolgreich generiert wurde
* Überprüfen Sie die Report-Konfiguration

</details>

<details>

<summary><strong>QR-Code lässt sich nicht scannen</strong></summary>

* Prüfen Sie die Druckqualität
* Erhöhen Sie die QR-Code-Größe
* Stellen Sie ausreichend Kontrast sicher

</details>

<details>

<summary><strong>Zahlungslink kann nicht erstellt werden</strong></summary>

Beim Klicken auf "Zahlungslink erstellen" erscheint ein Fehler.

#### Mögliche Ursachen

#### *"API-Key nicht konfiguriert"*

**Lösung:**

1. Öffnen Sie **Mollie Einrichtung**
2. Geben Sie Ihren API-Key ein
3. Testen Sie die Verbindung

#### *"Betrag ist ungültig"*

**Lösung:**

* Prüfen Sie den Rechnungsbetrag
* Mindestbetrag: 1,00 EUR (kann je nach Methode variieren)
* Höchstbetrag: Abhängig von Zahlungsmethode

#### *"Währung nicht unterstützt"*

**Lösung:**

* Prüfen Sie die Währung des Belegs
* Mollie unterstützt: EUR, GBP, USD und weitere
* Ggf. Standardwährung in Einrichtung anpassen

</details>

<details>

<summary><strong>Status bleibt auf "Open"</strong></summary>

Nach Erstellen des Links bleibt der Status auf "Open", obwohl der Kunde bezahlt hat.

#### Mögliche Ursachen

1. **Webhooks nicht konfiguriert**
   * Ohne Webhooks keine automatischen Updates
   * Lösung: Webhooks aktivieren
2. **Webhook nicht angekommen**
   * Prüfen Sie das Webhook-Log
   * Lösung: Webhook-Konfiguration prüfen
3. **Zahlung noch nicht abgeschlossen**
   * Manche Zahlungsmethoden dauern länger
   * Lösung: Status manuell aktualisieren

#### Sofort-Lösung

1. Öffnen Sie die Rechnung
2. Klicken Sie auf **"Status aktualisieren"**
3. Der aktuelle Status wird von Mollie abgerufen

</details>

<details>

<summary><strong>Kunde kann nicht bezahlen</strong></summary>

Kunde meldet, dass die Zahlung nicht funktioniert.

#### Prüfung

1. **Zahlungslink testen**
   * Öffnen Sie den Link selbst
   * Wird die Zahlungsseite angezeigt?
2. **Zahlungsstatus prüfen**
   * Status "Expired"? → Link ist abgelaufen
   * Status "Canceled"? → Zahlung wurde abgebrochen

#### Lösungen

#### Link abgelaufen

1. Erstellen Sie einen neuen Zahlungslink
2. Senden Sie den neuen Link an den Kunden

#### Zahlungsmethode nicht verfügbar

* Prüfen Sie, welche Methoden aktiviert sind
* Ggf. fehlende Methode in Mollie aktivieren

#### Technisches Problem beim Kunden

* Anderer Browser probieren
* Cookies und Cache löschen
* Bei anhaltendem Problem: Mollie Support

</details>

<details>

<summary><strong>Doppelte Zahlungen</strong></summary>

Kunde wurde mehrfach belastet für dieselbe Rechnung.

### Prüfung

1. Prüfen Sie die Transaktionsliste
2. Gibt es mehrere Zahlungslinks für dieselbe Rechnung?
3. Prüfen Sie in Mollie: Wurden mehrere Zahlungen durchgeführt?

### Lösung

1. Identifizieren Sie die überzählige Zahlung
2. Erstellen Sie eine Erstattung für den Doppelbetrag
3. Informieren Sie den Kunden

### Prävention

* Erstellen Sie nur einen Zahlungslink pro Rechnung
* Prüfen Sie vor dem Erstellen, ob bereits ein Link existiert

</details>

<details>

<summary><strong>Betrag stimmt nicht</strong></summary>

Bezahlter Betrag weicht vom Rechnungsbetrag ab.

#### Mögliche Ursachen

1. **Währungsumrechnung**
   * Bei Fremdwährungen kann der Betrag abweichen
2. **Zahlungslink mit altem Betrag**
   * Rechnung wurde nach Link-Erstellung geändert
3. **Teilzahlung**
   * Nicht alle Zahlungsmethoden erzwingen den vollen Betrag

#### Lösung

* Differenz manuell ausgleichen
* Bei Überzahlung: Teilerstattung
* Bei Unterzahlung: Neuen Link für Restbetrag

</details>

<details>

<summary><strong>QR-Code funktioniert nicht</strong></summary>

QR-Code lässt sich nicht scannen oder führt nicht zur Zahlung.

#### Lösungen

1. **Druckqualität verbessern**
   * Höhere Auflösung wählen
   * Größeren QR-Code drucken
2. **Kein Zahlungslink vorhanden**
   * Prüfen Sie, ob ein Zahlungslink erstellt wurde
   * QR-Code wird aus dem Link generiert
3. **Link abgelaufen**
   * Erstellen Sie einen neuen Zahlungslink
   * Drucken Sie das Dokument neu

</details>

<details>

<summary><strong>Checkliste Zahlungsprobleme</strong></summary>

* [ ] API-Key korrekt und aktiv?
* [ ] Betrag gültig (Minimum/Maximum)?
* [ ] Währung unterstützt?
* [ ] Zahlungsmethoden aktiviert?
* [ ] Zahlungslink noch gültig (nicht expired)?
* [ ] Webhooks funktionieren?
* [ ] Kunde nutzt unterstützten Browser?

</details>

### Erstattungen

<details>

<summary><strong>Wie lange dauert eine Erstattung?</strong></summary>

Typisch: **1-5 Werktage**, abhängig von der ursprünglichen Zahlungsmethode und der Bank des Kunden.

</details>

<details>

<summary><strong>Kann ich eine Erstattung rückgängig machen?</strong></summary>

**Nein.** Erstattungen sind unwiderruflich. Prüfen Sie Betrag und Rechnung sorgfältig vor der Erstellung.

</details>

<details>

<summary><strong>Kann ich mehr erstatten als bezahlt wurde?</strong></summary>

**Nein.** Die Summe aller Erstattungen darf den ursprünglichen Zahlungsbetrag nicht überschreiten.

</details>

<details>

<summary><strong>Kein Payment ID gefunden</strong></summary>

* Die Rechnung hat keinen gültigen Zahlungslink
* Prüfen Sie, ob eine Zahlung durchgeführt wurde

</details>

<details>

<summary><strong>Erstattungsbetrag zu hoch</strong></summary>

* Sie können nicht mehr erstatten als bezahlt wurde
* Prüfen Sie bereits getätigte Erstattungen

</details>

<details>

<summary><strong>Erstattung fehlgeschlagen</strong></summary>

* Prüfen Sie die API-Verbindung
* Überprüfen Sie den Zahlungsstatus bei Mollie
* Kontaktieren Sie den Support bei anhaltenden Problemen

</details>

### Wiederkehrende Zahlungen

<details>

<summary><strong>Benötige ich für wiederkehrende Zahlungen spezielle Freigaben?</strong></summary>

**Ja.** Wiederkehrende Zahlungen (Recurring Payments) müssen in Ihrem Mollie-Konto freigeschaltet sein. Kontaktieren Sie Mollie für die Aktivierung.

</details>

<details>

<summary><strong>Werden Abonnement-Zahlungen automatisch als Rechnungen erstellt?</strong></summary>

**Nein.** Die Mollie Integration führt nur die Zahlungen aus. Die Erstellung entsprechender Rechnungen in Business Central muss separat erfolgen.

</details>

### Technisch

<details>

<summary><strong>Werden meine Daten sicher übertragen?</strong></summary>

**Ja.** Alle Kommunikation mit der Mollie API erfolgt über HTTPS (TLS-verschlüsselt). Sensible Daten wie Kreditkartennummern werden niemals in Business Central gespeichert.

</details>

<details>

<summary><strong>Kann ich die Integration im Testmodus nutzen?</strong></summary>

**Ja.** Nutzen Sie den Test-API-Key für Testzahlungen. Es werden keine echten Transaktionen durchgeführt.

</details>

<details>

<summary><strong>Was passiert bei einem Mollie-Ausfall?</strong></summary>

Bei einem Ausfall auf Mollie-Seite:

* Neue Zahlungslinks können nicht erstellt werden
* Bestehende Links funktionieren nicht
* Webhooks werden nachgeliefert, sobald Mollie wieder verfügbar ist

Prüfen Sie [status.mollie.com](https://status.mollie.com) für aktuelle Informationen.

</details>

<details>

<summary><strong>Wie oft werden Daten synchronisiert?</strong></summary>

* **Mit Webhooks:** Echtzeit (Sekunden)
* **Ohne Webhooks:** Manuell oder beim Öffnen von Belegen

</details>

<details>

<summary><strong>Ein Mitarbeiter ohne Mollie Integration Lizenz bekommt eine Fehlermeldung, wenn er z.B. eine Rechnung öffnen möchte. Woran liegt das?</strong></summary>

Bitte prüfen Sie, ob dem Mitarbeiter eine Basic User Lizenz zugewiesen ist. Siehe [Lizenzzuweisung](/mollie-integration/erste-schritte/lizenzzuweisung.md)

</details>

## Ihre Frage war nicht dabei?

Kontaktieren Sie unser Support-Team:

{% content-ref url="/pages/qkvKhMDqEYcC9qXpgtTZ" %}
[Supportkontakt](/mollie-integration/fehlerbehebung-and-support/supportkontakt.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solutioo.de/mollie-integration/fehlerbehebung-and-support/haeufige-fragen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.