konfipay help center

Häufige Fehler und ihre Behebung

konfipaySync 2.0 wurde am 31.10.2026 veröffentlicht.

Die meisten Meldungen von konfipaySync nennen bereits, was passiert ist und was zu tun ist. Diese Seite fasst die häufigsten Fälle zusammen. Den genauen Ablauf eines Laufs zeigt immer sein Ausführungsprotokoll (siehe Protokoll und Laufdetails).

Installation und Start

Beobachtung

Ursache und Abhilfe

Das Programmfenster meldet konfipaySync ist nicht erreichbar.

Nach einem Neustart des Rechners braucht der Dienst bis zu einer Minute; klicken Sie dann auf Erneut versuchen. Sonst prüfen Sie in der Dienste-Verwaltung, ob der Dienst konfipaySync läuft, und starten ihn bei Bedarf. Den Grund, warum er nicht läuft, nennt die Ereignisanzeige unter Windows-Protokolle › Anwendung, Quelle konfipaySync.

Der Dienst startet nicht; die Ereignisanzeige meldet einen belegten Port.

Ein anderes Programm verwendet Port 8080. Tragen Sie in konfipaysync.settings.json unter Urls einen freien Port ein, starten Sie den Dienst neu und rufen Sie die Oberfläche unter der neuen Adresse auf.

Der Dienst startet nicht; die Ereignisanzeige meldet, dass die eigene Ablage nicht beschreibbar ist.

Das Konto, unter dem der Dienst läuft, braucht Schreibrecht auf C:\ProgramData\konfipaySync\data. Das betrifft vor allem ein nachträglich eingestelltes Domänen-Dienstkonto.

Die Oberfläche ist von einem anderen Arbeitsplatz aus nicht erreichbar.

In der Vorgabe ist sie nur auf dem Rechner des Dienstes erreichbar. Für den Zugriff über das Netz gehört ein Reverse Proxy mit TLS davor (siehe Betriebseinstellungen im Artikel konfipaySync 2.0).

Das Programmfenster startet nicht; Windows verlangt .NET Framework 4.8.

Auf Windows Server 2019 ist .NET Framework 4.8 nicht immer installiert. Installieren Sie es nach, oder rufen Sie die Oberfläche auf diesem Rechner im Browser unter http://localhost:8080 auf.

Anmeldung

Meldung

Ursache und Abhilfe

Ihre Anmeldung bei konfipay war erfolgreich, konfipaySync steht Ihnen jedoch nicht zur Verfügung …

Ihr Benutzer hat nicht die Rolle Administrator im konfipay-Account. Ein Administrator Ihres Accounts kann Ihnen die Rolle zuweisen oder die Einrichtung selbst vornehmen.

Die Anmeldung ist fehlgeschlagen. Bitte prüfen Sie E-Mail-Adresse und Passwort.

Prüfen Sie die Angaben und ob die richtige konfipay-Instanz gewählt ist (portal.konfipay.de oder portal.konfipay.ch).

Zu viele Fehlversuche …

Warten Sie die angezeigte Zeit ab und versuchen Sie es erneut.

Der Code ist nicht korrekt oder abgelaufen.

Jeder Code lässt sich nur einmal verwenden. Kehren Sie zur Anmeldung zurück; konfipay stellt dann einen neuen Code aus.

Dieser Account meldet sich über Microsoft an …

Für Ihren Account ist die Anmeldung über Microsoft vorgeschrieben. Eine Anmeldung an konfipaySync ist damit derzeit nicht möglich.

Passwortwechsel erforderlich

Ändern Sie Ihr Passwort im konfipay-Portal und melden Sie sich danach erneut an.

API-Schlüssel

Fehlt der Schlüssel oder arbeitet er nicht, steht das auf jeder Seite oben in Rot; fehlende Berechtigungen meldet die Übersicht. Die Ursache zeigt Einstellungen › API-Schlüssel.

Meldung

Ursache und Abhilfe

Es ist kein API-Schlüssel hinterlegt.

Hinterlegen Sie unter Einstellungen › API-Schlüssel einen Schlüssel Ihres konfipay-Accounts. Bis dahin läuft keine Aufgabe.

konfipay lehnt den Schlüssel ab …

Der Schlüssel wurde im Portal gelöscht, ist abgelaufen oder wurde nicht vollständig eingegeben. Entfernen Sie ihn mit Schlüssel entfernen und hinterlegen Sie einen gültigen.

Der Schlüssel gehört zu einem anderen konfipay-Account als dieser Mandant.

Verwenden Sie einen Schlüssel des Accounts, mit dem Sie angemeldet sind.

konfipay war bei der Prüfung nicht erreichbar …

Der Schlüssel selbst ist womöglich in Ordnung. Prüfen Sie die Internetverbindung des Rechners und ob die Firewall HTTPS zu portal.konfipay.de bzw. portal.konfipay.ch zulässt, und prüfen Sie später erneut.

Der gespeicherte Schlüssel lässt sich nicht mehr entschlüsseln …

Der Schlüsselring unter C:\ProgramData\konfipaySync\data fehlt oder gehört zu einer anderen Installation, etwa nach einer Neuinstallation. Entfernen Sie den Schlüssel und hinterlegen Sie ihn neu.

Dem API-Schlüssel fehlen benötigte Berechtigungen.

Aufgaben, die eine fehlende Berechtigung brauchen, scheitern beim Lauf. Vergeben Sie die Berechtigung im konfipay-Portal am Schlüssel und klicken Sie auf Schlüssel erneut prüfen.

Die Konten konnten nicht von konfipay gelesen werden … bzw. Die EBICS-Zugänge konnten nicht … gelesen werden

Prüfen Sie den Schlüssel unter Einstellungen › API-Schlüssel, insbesondere die Berechtigungen BankAccounts, PayPal bzw. Ebics.

Verzeichnisse

Meldung

Ursache und Abhilfe

konfipaySync kann diesen Pfad nicht verwenden.

Der Pfad liegt in einem System- oder Programmverzeichnis oder außerhalb der Verzeichnisse, die die IT freigegeben hat. Wählen Sie ein anderes Verzeichnis.

Der Pfad ist nicht erreichbar.

Meist ein Laufwerksbuchstabe wie W:, den der Dienst nicht sieht, oder ein Server, den der Rechner des Dienstes nicht erreicht. Verwenden Sie den UNC-Pfad (\\server\freigabe\ordner).

Prüfen zeigt Lesen ✗, Schreiben ✗ oder Ändern ✗.

Dem Konto, mit dem geprüft wurde, fehlt das Recht. Der Dienst greift mit seinem eigenen Konto zu, nicht mit Ihrem: Berechtigen Sie das Dienstkonto bzw. das Computerkonto des Rechners auf dem Ordner, oder hinterlegen Sie Zugangsdaten für die Freigabe.

Prüfen meldet einen falschen Benutzernamen oder ein falsches Kennwort.

Die Freigabe verlangt eine eigene Anmeldung, etwa auf einem NAS. Hinterlegen Sie unter dem Feld oder unter Einstellungen › Netzwerkfreigaben einen Benutzer mit Lese- und Schreibrecht.

Ein Lauf endet mit der Meldung, dass das Quellverzeichnis fehlt.

Das Quellverzeichnis wird nicht automatisch angelegt. Legen Sie es an oder korrigieren Sie den Pfad in der Aufgabe.

Abruf

Beobachtung

Ursache und Abhilfe

Es kommen keine Dateien an; der Lauf endet mit Erfolgreich – nichts zu tun.

konfipay hatte keine neuen Dokumente für diese Aufgabe. Prüfen Sie Format und Kontoauswahl der Aufgabe. Ruft eine andere Anwendung mit demselben API-Schlüssel ab und quittiert, sind die Dokumente für konfipaySync schon abgerufen – verwenden Sie dann getrennte Schlüssel mit Quittierung je API-Schlüssel.

Es kommen keine Dateien an; die Aufgabe läuft gar nicht.

Prüfen Sie, ob die Aufgabe aktiv ist und einen aktiven Zeitplan hat (siehe Zeitpläne und Läufe unten).

Die Kachel Ausstehende Quittierungen zeigt eine Zahl größer null.

Die Dokumente sind abgelegt, die Quittierung bei konfipay ist aber gescheitert. konfipaySync holt sie beim nächsten Lauf nach und legt die Dokumente dabei nicht noch einmal ab. Bleibt die Zahl bestehen, prüfen Sie den API-Schlüssel.

Das Dateinamensmuster wird abgewiesen, ein Baustein bleibe leer.

Der Aufgabentyp liefert diese Angabe nicht, etwa keine IBAN bei PayPal oder bei sonstigen Dokumenten. Verwenden Sie einen der angebotenen Bausteine (siehe Dateinamen, Platzhalter und Dateimuster).

Übertragung

Beobachtung

Ursache und Abhilfe

Eine Datei im Quellverzeichnis wird nicht übertragen.

  • Ihr Name passt nicht zum Dateimuster – die Zeile Erkannt am Feld zeigt, welche Muster gelten.

  • Sie ist noch nicht vollständig: Sie wurde vor weniger als 30 Sekunden geändert, ist noch geöffnet oder ihre .done-Markierung fehlt.

  • Sie liegt in einem Unterordner, und Unterverzeichnisse einbeziehen ist aus.

Eine Datei erscheint als Duplikat übersprungen.

Eine Datei mit genau demselben Inhalt wurde bereits erfolgreich übertragen; sie wird deshalb nicht noch einmal übertragen und wie eine übertragene Datei archiviert oder gelöscht. Soll eine Zahlung tatsächlich erneut ausgeführt werden, erzeugen Sie in Ihrer Software eine neue Zahlungsdatei.

Eine Datei liegt im Fehlerverzeichnis.

Ihre Übertragung ist fehlgeschlagen, etwa weil konfipay die Datei abgewiesen hat. Den Grund nennt das Ausführungsprotokoll des Laufs. Beheben Sie die Ursache und legen Sie eine korrigierte Datei in das Quellverzeichnis.

Eine Datei hat den Status Ausgang unklar, die Kachel Übertragungen ohne Entscheidung ist rot.

Während der Übertragung brach die Verbindung ab oder der Dienst wurde beendet; ob die Datei bei konfipay angekommen ist, ließ sich nicht feststellen. konfipaySync überträgt sie deshalb nicht automatisch erneut. Prüfen Sie im konfipay-Portal, ob die Zahlungsdatei angekommen ist, und wenden Sie sich mit dem Ergebnis an den Support. Übertragen Sie die Datei nicht auf anderem Weg erneut, solange das nicht geklärt ist.

In konfipay ist kein EBICS-Zugang eingerichtet. oder ein Zugang ist als nicht initialisiert gekennzeichnet (Dokumente einreichen)

Richten Sie den EBICS-Zugang in konfipay ein bzw. schließen Sie seine Initialisierung ab und aktualisieren Sie die Auswahl mit Zugänge aktualisieren.

Zeitpläne und Läufe

Beobachtung

Ursache und Abhilfe

Eine Aufgabe läuft nicht zur erwarteten Zeit.

Prüfen Sie, ob Aufgabe und Zeitplan aktiv sind, und sehen Sie sich in der Vorschau des Zeitplans die nächsten Ausführungen und die Zeitzone an. War der Rechner oder der Dienst zum geplanten Zeitpunkt aus, holt konfipaySync die Ausführung beim nächsten Start einmal nach, sofern Verpasste Ausführung auf Einmalig nachholen steht.

Ein geplanter Start fällt aus, während ein Lauf noch aktiv ist.

Die Einstellung Wenn bereits ein Lauf aktiv ist steht auf Abweisen. Mit Einreihen wird der Start im Anschluss ausgeführt.

Ein Lauf endet mit Zeitlimit überschritten.

Der Lauf hat sehr viele oder sehr große Dateien verarbeitet. Erhöhen Sie das Zeitlimit der Aufgabe im Abschnitt Ausführung.

Das Intervall muss 60 Minuten glatt teilen oder ein Vielfaches voller Stunden sein …

Wählen Sie 5, 10, 15, 20, 30 oder 60 Minuten bzw. volle Stunden.

Datenübernahme

Meldung

Ursache und Abhilfe

An den üblichen Ablageorten wurde keine Datenbank der Vorgängerversion gefunden.

Geben Sie den Pfad der Datenbank von Hand an oder kopieren Sie sie von dem Rechner, auf dem die bisherige Anwendung läuft.

Die Übernahme ist nicht möglich (roter Hinweis in der Vorschau)

Der Dienst darf die Aufgaben der bisherigen Anwendung im Windows-Aufgabenplaner nicht abschalten. Schalten Sie sie unter \konfipaySync selbst ab (Rechtsklick, Deaktivieren, nicht löschen) und erstellen Sie die Vorschau erneut.

Der Windows-Aufgabenplaner ist nicht lesbar

Ob die bisherige Automatisierung abgeschaltet ist, ließ sich nicht feststellen; die Übernahme findet deshalb nicht statt. Die Meldung des Aufgabenplaners steht dabei. Wenden Sie sich mit ihr an den Support.

Der Schlüssel aus der Vorgängerversion ist nicht verwendbar …

Hinterlegen Sie nach der Übernahme unter Einstellungen › API-Schlüssel einen gültigen Schlüssel.

Support

Hilft keiner der Hinweise weiter, wenden Sie sich an den konfipay-Support unter support@konfipay.de. Bitte geben Sie an:

  • die Versionsnummer aus der Fußzeile der Oberfläche,

  • die betroffene Aufgabe und den Zeitpunkt des Laufs,

  • den CSV-Export der Laufdetails und den Auszug aus dem Ausführungsprotokoll,

  • bei Problemen mit dem Dienst die Meldung aus der Ereignisanzeige.