| Docs Hilfe
  AppSource  
Diese Seite druckenGesamtes Handbuch (Druckversion)
Docs  /  NAVAX Zahlungsverkehr  /  Informationen für Entwickler

 konfipay


2025/05/26 • 9 Min. Lesedauer
Fehlermeldungen entstehen ab und zu durch einen fehlerhaften Dateiaufbau oder öfter durch fehlende bankenseitige Berechtigungen. Seltener sind Verbindungsabbrüche oder allgemeine Übertragungsfehler zum Bankserver die Ursache. Hierzu beinhaltet konfipay ein ausgeklügeltes Warn- und Hinweissystem.

Wie werden Fehler identifiziert

konfipay verfügt über eine Fehlererkennung, welche bereits die eingereichte Zahlungsdatei auf formelle Fehler prüft und damit dafür sorgt, dass diese Datei gar nicht erst zur Bank gelangt. Auch eine fein abgestimmte Dublettenprüfung seitens konfipay vermeidet potentielle Doppeleinreichungen. Nachstehend finden Sie eine Auflistung der Fehlercodes die bei der Synchronisation mit der konfipay Online Payment Services API auftreten können. Fehler können über das konfipay Dienstprotokoll ausgelesen werden.

Aufbau der Fehlercodes

ERR-{Category}-{Number} ERR - Festes Präfix für alle Fehlercodes {Category} - Kategorie des Fehlers {Number} - Nummer des Fehlers. Die Nummer ist innerhalb ihrer Kategorie eindeutig.

Liste aller Fehlercodes und Fehlermeldungen mit Erklärung

ERR-01-XXXX - Kategorie: Ungültiger String-Parameter
ERR-01-0001 RIdNotFound Für den angegebenen RId gibt es keine Ressource.
ERR-01-0002 MsgIdNotFound Es gibt keine Ressource für die angegebene Nachrichtenkennung.
ERR-01-0003 AmbiguousMsgId Die angegebene Nachrichtenkennung ist mehrdeutig.
ERR-01-0004 InvalidStartDate Das Startdatum wurde nicht als gültiges Datum erkannt.
ERR-01-0005 InvalidEndDate Das Enddatum wurde nicht als gültiges Datum erkannt.
ERR-01-0006 InvalidPeriod Der angegebene Zeitraum ist nicht gültig (Anfangs- und Enddatum müssen chronologisch sein).
ERR-01-0007 InvalidDate Das Datum wurde nicht als gültiges Datum erkannt.
ERR-01-0008 TransactionIdNotFound Es gibt keine Ressource für die angegebene Transaktions-ID.
ERR-01-0009 InvalidTransactionId Die angegebene Transaktionsnummer ist ungültig (leer oder mehr als 19 Zeichen).
ERR-01-0010 AmbiguousTransactionId Die angegebene Transaktions-ID ist mehrdeutig.
ERR-01-0011 EMailAddressOrMerchantIdNotFound Für die angegebene E-Mail- oder Händlerkennung gibt es keine Ressource.
ERR-01-0012 MissingParameter Ein erforderlicher Parameter ist nicht gesetzt.
ERR-01-0013 BankNotFound Die gewünschte Bank wurde nicht gefunden.
ERR-01-0014 InvalidGateway Das angeforderte Gateway wird nicht unterstützt. Nur "SRZ", "EBICS" oder eine gültige rId sind zulässig.
ERR-01-0015 UnsupportedApiVersion Die API-Version wird für die angeforderte Ressource nicht unterstützt.
ERR-01-0016 InvalidQueryStringValue Der Query-String-Parameter enthält einen ungültigen Wert.
ERR-02-XXXX - Kategorie: Inhaltsüberprüfung fehlgeschlagen
ERR-02-0000 ContentValidationFailed Die Validierung des Inhalts ist fehlgeschlagen. Weitere Informationen über den genauen Grund finden Sie in den Fehlerdetails.
ERR-02-0001 invalidRId Die angegebene RId ist ungültig (leer oder nicht 36 Zeichen lang).
ERR-02-0002 invalidXmlCharacter Die Datei enthält nach dem DFÜ-Abkommen ungültige Zeichen.
ERR-02-0003 MissingXmlNamespace Der XML Dokument enthält keinen gültigen XML Namespace.
ERR-02-0004 InvalidXmlNamespacePrefix Der XML-Namespace-Präfix ist ungültig.
ERR-02-0005 PainVersionNotSupported Die angegebene Schmerzversion wird von konfipay nicht unterstützt.
ERR-02-0006 PainVersionReleaseDateNotReached Die im XML-Dokument angegebene Schmerzversion ist (noch) nicht gültig.
ERR-02-0007 SchemaValidationError Die Validierung des XML-Dokuments anhand des XML-Schemas ist fehlgeschlagen.
ERR-02-0008 InitPartyIbanChecksumValidationFailed Die IBAN-Prüfsumme des Auftraggeberkontos ist ungültig.
ERR-02-0009 OtherPartyIbanChecksumValidationFailed Die IBAN-Prüfsumme eines Begünstigten/Zahlungsempfängers ist ungültig.
ERR-02-0010 InvalidIbanIsoCountryCode Der in der IBAN enthaltene ISO-Ländercode ist ungültig oder wird nicht unterstützt.
ERR-02-0011 TransactionLimitExceeded Die maximal zulässige Anzahl von Transaktionen pro Zahlungsauftrag wurde überschritten.
ERR-02-0012 LocalInstrumentMashup Der Beleg enthält mehr als eine Zahlungsmethode.
ERR-02-0013 InvalidServiceLevel Die angegebene Leistungsstufe ist ungültig (dringende Zahlungen sind nicht zulässig).
ERR-02-0014 InvalidExecutionDate Das Ausführungsdatum liegt zu weit in der Zukunft/Vergangenheit.
ERR-02-0015 InvalidInitiatingPartyIban Das Bankkonto ist dem Benutzerkonto nicht zugeordnet oder ist inaktiv.
ERR-02-0016 IbanBicMismatch Die Bankleitzahl der IBAN stimmt nicht mit dem BIC des Finanzinstituts überein.
ERR-02-0017 ControlSumMismatch Die angegebene Prüfsumme in der Kopfzeile oder eine Zahlung stimmt nicht mit dem Inhalt überein.
ERR-02-0018 NumberOfTransactionsMismatch Die angegebene Anzahl der Transaktionen in der Kopfzeile oder eine Zahlung stimmt nicht mit dem Inhalt überein.
ERR-02-0019 InvalidOtherPartyCountry Das Bankkonto des Begünstigten/Zahlers befindet sich nicht in einem SEPA-Teilnehmerland.
ERR-02-0020 InvalidBankAccountIban Die Prüfsumme der IBAN des Bankkontos ist ungültig.
ERR-02-0021 InvalidBankAccountAdditionalInformation Der Inhalt überschreitet die maximale Länge von 500 Zeichen.
ERR-02-0022 InvalidCreditorId Die Struktur der Gläubigeridentifikation ist ungültig.
ERR-02-0023 MissingRefundIdentifier Es wurde keine Kennung für die Transaktion angegeben (Transaktions-ID oder RId).
ERR-02-0024 InvalidRefundMemo Der für die Erstattung angegebene Vermerk ist ungültig (max. 255 Zeichen).
ERR-02-0025 InvalidRefundType Die angegebene Erstattungsart ist ungültig. Mögliche Erstattungsarten: Vollständig oder Teilweise.
ERR-02-0026 MissingRefundAmount Der zu erstattende Betrag ist erforderlich, aber nicht angegeben. Der Betrag ist erforderlich, wenn refundType mit Partial angegeben wurde.
ERR-02-0027 InvalidRefundAmountValue Der Wert des zu erstattenden Betrags ist ungültig.
ERR-02-0028 InvalidRefundAmountCurrency Die Währung des zu erstattenden Betrags ist ungültig.
ERR-02-0029 DtazvValidationFailed Die Validierung der DTAZV-Datei ist fehlgeschlagen.
ERR-02-0030 IbanValidationFailed Die Validierung der IBAN ist fehlgeschlagen.
ERR-02-0031 InvalidBlz Die Bankleitzahl ist ungültig.
ERR-02-0032 ContainerVersionNotSupported Die im XML-Beleg angegebene Containerversion wird nicht unterstützt.
ERR-02-0033 CamtVersionNotSupported Die im XML-Beleg angegebene camt-Version wird nicht unterstützt.
ERR-02-0034 InvalidValue Ein Feld im übertragenen Json oder XML Beleg hat einen ungültigen Wert.
ERR-02-0035 OtherPartyAddressRequired Bei Zahlungsaufträgen, deren Gegenkonto sich nicht in einem EU-Teilnehmerland befindet, und bei einem Betrag von > 1000€, ist die Angabe der Adresse obligatorisch.
ERR-02-0036 DeprecatedLocalInstrument Die Datei enthält den nicht unterstützten Lastschrifttyp "COR1". Es werden nur "CORE" und "B2B" unterstützt. "COR1" kann über die API-Einstellungen automatisch in "CORE" umgewandelt werden.
ERR-02-0037 InvalidLocalInstrument Die Datei enthält einen ungültigen Wert für diese Zahlungsart im Feld "LocalInstrument".
ERR-02-0038 PaymentMessageIsNotUnique Die Message ID der Zahlungsdatei muss einmalig sein. Dies ist eine optionale Prüfung, die in den API-Einstellungen deaktiviert werden kann.
ERR-03-XXXX - Kategorie: Inhalt nicht lesbar
ERR-03-0001 NoContentReceived Es wurden keine Inhalte übertragen.
ERR-03-0002 InvalidContentType Der angegebene Inhaltstyp des übertragenen Inhalts ist ungültig.
ERR-03-0003 InvalidFileStructure Die Struktur der übertragenen Datei ist syntaktisch ungültig.
ERR-03-0004 InvalidXmlDocument Der übertragene Inhalt entspricht nicht einem wohlgeformten XML Beleg.
ERR-03-0005 InvalidLoginCredentials Die syntaktische Struktur der Anmeldeinformationen ist ungültig.
ERR-03-0006 InvalidBankAccount Die syntaktische Struktur der Bankkontoinformationen ist ungültig.
ERR-03-0007 InvalidRefund Die syntaktische Struktur der Erstattungsinformationen ist ungültig.
ERR-03-0008 ContentNotReadable Die übertragene Text-, Json oder XML-Datei hat nicht die erwartete Struktur.
ERR-04-XXXX - Kategorie: Voraussetzungen nicht erfüllt
ERR-04-0001 MissingScope Der zur Authentifizierung verwendete API-Schlüssel verfügt nicht über die erforderlichen Berechtigungen für den Zugriff auf die angeforderte Ressource.
ERR-04-0002 SrzMappingFailed Die Ermittlung des Service-Rechenzentrums für die Einreichung der Zahlungsdatei ist fehlgeschlagen.
ERR-04-0003 EbicsContactMappingFailed Es wurde kein vollständig initialisierter EBICS-Kontakt für die Übertragung der Zahlungsdatei gefunden.
ERR-04-0004 MissingEbicsOrderType Der EBICS-Kontakt hat nicht die erforderliche Auftragsart für die Zahlungsart.
ERR-04-0005 InvalidEbicsContact Der EBICS-Kontakt für die Übertragung der Zahlungsdatei ist nicht vollständig initialisiert oder nicht für den Versand von Zahlungen konfiguriert.
ERR-04-0006 InvalidPaymentStatus TDer Status der Zahlung ist bereits auf "ausgeführt" gesetzt. Eine neue Ausführung ist nur möglich, wenn der Parameter force auf true gesetzt ist.
ERR-04-0007 BankAccountIbanAlreadyExists Es existiert bereits ein Bankkonto mit der angegebenen IBAN.
ERR-04-0008 InactiveBankAccount Das Bankkonto wird in konfipay deaktiviert.
ERR-04-0009 UnknownBankAccount Es wurde kein Bankkonto für die angegebene IBAN gefunden.
ERR-04-0010 AmbiguousRefundIdentifier Die Kennung für die Erstattungstransaktion ist nicht mehrdeutig.
ERR-04-0011 DuplicateFound Die Datei wurde als Duplikat identifiziert.
ERR-04-0012 IndividualRestriction Die Zahlungsdatei kann aufgrund einer individuellen Beschränkung des Finanzinstituts nicht akzeptiert werden.
ERR-04-0013 ClientBlocked Die Client-Anwendung wurde von konfipay blockiert. Weitere Informationen über den genauen Grund finden Sie in den Fehlerdetails.
ERR-04-0014 InsufficientPermissions Der Client ist nicht berechtigt, den angeforderten Vorgang durchzuführen. Weitere Informationen über den genauen Grund finden Sie in den Fehlerdetails.
ERR-05-XXXX - Kategorie: Verarbeitungsfehler
ERR-05-0000 ProcessingError Bei der Bearbeitung der Anfrage ist ein Fehler aufgetreten. Weitere Informationen über den genauen Grund finden Sie in den Fehlerdetails.
ERR-05-0001 EbicsError Bei der Durchführung der EBICS-Aktion ist ein Fehler aufgetreten.
ERR-05-0002 PayPalError Bei der Durchführung der PayPal-Aktion ist ein Fehler aufgetreten.
ERR-05-0003 PayPalUnspecifiedError Während der Ausführung der PayPal-Aktion ist ein Fehler aufgetreten, der nicht von PayPal angegeben wurde.

Feedback senden für
DE|EN Impressum
◀☰▶
△