# 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](https://docs.solutioo.de/mollie-integration/erste-schritte/mollie-konto-erstellen "mention")

</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](https://docs.solutioo.de/mollie-integration/erste-schritte/lizenzzuweisung "mention")

</details>

## Ihre Frage war nicht dabei?

Kontaktieren Sie unser Support-Team:

{% content-ref url="supportkontakt" %}
[supportkontakt](https://docs.solutioo.de/mollie-integration/fehlerbehebung-and-support/supportkontakt)
{% endcontent-ref %}