API-Fehlercodes
Die API verwendet ein strukturiertes Fehlercodesystem, das eine eindeutige Identifikation des aufgetretenen Fehlers ermöglicht. Jeder Fehlercode folgt einem standardisierten Aufbau, der sowohl die Kategorie als auch die spezifische Kennung des Fehlers angibt. Dadurch lassen sich Fehler schnell zuordnen und effizient beheben.
Aufbau der Fehlercodes
Die Fehlercodes folgen dem folgenden Schema:ERR-{Category}-{Number}
ERR– Ein fester Präfix, der aktuell für alle Fehlercodes verwendet wird. Dieses Präfix wurde eingeführt, um künftig auch andere Meldungstypen wie Warnungen zu unterstützen (derzeit nicht der Fall). Es dient zur eindeutigen Kennzeichnung von Fehlermeldungen und erleichtert die Unterscheidung von anderen Codes oder Statusmeldungen.{Category}– Die Kategorie des Fehlers, die den betroffenen Funktionsbereich oder die Art des Fehlers beschreibt.{Number}– Eine eindeutige Nummer innerhalb der jeweiligen Kategorie. Jede Nummer ist spezifisch für einen bestimmten Fehler und wiederholt sich nicht innerhalb derselben Kategorie.
Diese strukturierte Liste der Fehlercodes ermöglicht eine schnelle Identifikation und effiziente Behebung von Fehlern, die während der Nutzung der API auftreten können.
Liste aller Fehlercodes und Fehlermeldungen mit Erläuterung
ERR-01-XXXX – Kategorie: Ungültiger Zeichenketten-Parameter
ERR-01-0001 - RIdNotFound: Es wurde keine Ressource für die angegebene RId gefunden.
ERR-01-0002 - MsgIdNotFound: Es wurde keine Ressource für die angegebene Nachrichtenkennung gefunden.
ERR-01-0003 - AmbiguousMsgId: Die angegebene Nachrichtenkennung ist nicht eindeutig.
ERR-01-0004 - InvalidMinDate: Das angegebene Mindestdatum ist kein gültiges Datum.
ERR-01-0005 - InvalidMaxDate: Das angegebene Höchstdatum ist kein gültiges Datum.
ERR-01-0006 - InvalidPeriod: Der angegebene Zeitraum ist ungültig (Startdatum und Enddatum müssen chronologisch sein).
ERR-01-0007 - InvalidDate: Das angegebene Datum ist kein gültiges Datum.
ERR-01-0008 - TransactionIdNotFound: Es wurde keine Ressource für die angegebene Transaktions-ID gefunden.
ERR-01-0009 - InvalidTransactionId: Die angegebene Transaktions-ID ist ungültig (leer oder länger als 19 Zeichen).
ERR-01-0010 - AmbiguousTransactionId: Die angegebene Transaktions-ID ist nicht eindeutig.
ERR-01-0011 - EMailAddressOrMerchantIdNotFound: Es wurde keine Ressource für die angegebene E-Mail-Adresse oder Händler-ID gefunden.
ERR-01-0012 - MissingParameter: Ein erforderlicher Parameter wurde nicht angegeben.
ERR-01-0013 - BankNotFound: Die angegebene Bank wurde nicht gefunden.
ERR-01-0014 - InvalidGateway: Das angegebene Gateway wird nicht unterstützt. Erlaubt sind nur „SRZ“, „EBICS“ oder eine gültige rId.
ERR-01-0015 - UnsupportedApiVersion: Die angegebene 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: Inhaltsvalidierung fehlgeschlagen
ERR-02-0000 - ContentValidationFailed: Die Validierung des Inhalts ist fehlgeschlagen. Weitere Informationen zur genauen Ursache finden sich 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 gemäß DFÜ-Abkommen ungültige Zeichen.
ERR-02-0003 - MissingXmlNamespace: Das XML-Dokument enthält keinen gültigen XML-Namespace.
ERR-02-0004 - InvalidXmlNamespacePrefix: Das Präfix des XML-Namespaces ist ungültig.
ERR-02-0005 - PainVersionNotSupported: Die angegebene PAIN-Version wird von konfipay nicht unterstützt.
ERR-02-0006 - PainVersionReleaseDateNotReached: Die im XML-Dokument angegebene PAIN-Version ist (noch) nicht gültig.
ERR-02-0007 - SchemaValidationError: Die Validierung des XML-Dokuments gegen das XML-Schema ist fehlgeschlagen.
ERR-02-0008 - InitPartyIbanChecksumValidationFailed: Die IBAN-Prüfziffer des Auftraggeberkontos ist ungültig.
ERR-02-0009 - OtherPartyIbanChecksumValidationFailed: Die IBAN-Prüfziffer des Empfängerkontos ist ungültig.
ERR-02-0010 - InvalidIbanIsoCountryCode: Der im IBAN enthaltene ISO-Ländercode ist ungültig oder wird nicht unterstützt.
ERR-02-0011 - TransactionLimitExceeded: Die maximal zulässige Anzahl an Transaktionen pro Zahlungsauftrag wurde überschritten.
ERR-02-0012 - LocalInstrumentMashup: Das Dokument enthält mehr als eine Zahlungsart.
ERR-02-0013 - InvalidServiceLevel: Das angegebene Servicelevel ist ungültig (Eilzahlungen sind nicht erlaubt).
ERR-02-0014 - InvalidExecutionDate: Das Ausführungsdatum liegt zu weit in der Zukunft oder Vergangenheit.
ERR-02-0015 - InvalidInitiatingPartyIban: Das Bankkonto ist dem Benutzerkonto nicht zugeordnet oder inaktiv.
ERR-02-0016 - IbanBicMismatch: Der Bankcode der IBAN stimmt nicht mit dem BIC des Finanzinstituts überein.
ERR-02-0017 - ControlSumMismatch: Die im Header oder einer Zahlung angegebene Prüfsumme stimmt nicht mit dem Inhalt überein.
ERR-02-0018 - NumberOfTransactionsMismatch: Die im Header oder einer Zahlung angegebene Anzahl der Transaktionen stimmt nicht mit dem Inhalt überein.
ERR-02-0019 - InvalidOtherPartyCountry: Das Empfängerkonto befindet sich nicht in einem SEPA-Teilnehmerland.
ERR-02-0020 - InvalidBankAccountIban: Die IBAN-Prüfziffer 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äubiger-ID ist ungültig.
ERR-02-0023 - MissingRefundIdentifier: Es wurde keine Kennung für die Rückerstattung angegeben (Transaktions-ID oder RId).
ERR-02-0024 - InvalidRefundMemo: Die für die Rückerstattung angegebene Notiz ist ungültig (max. 255 Zeichen).
ERR-02-0025 - InvalidRefundType: Der angegebene Rückerstattungstyp ist ungültig. Mögliche Typen: „Full“ oder „Partial“.
ERR-02-0026 - MissingRefundAmount: Der Rückerstattungsbetrag wurde nicht angegeben. Der Betrag ist erforderlich, wenn der Rückerstattungstyp „Partial“ ist.
ERR-02-0027 - InvalidRefundAmountValue: Der angegebene Rückerstattungsbetrag ist ungültig.
ERR-02-0028 - InvalidRefundAmountCurrency: Die Währung des Rückerstattungsbetrags 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 angegebene Bankleitzahl ist ungültig.
ERR-02-0032 - ContainerVersionNotSupported: Die im XML-Dokument angegebene Containerversion wird nicht unterstützt.
ERR-02-0033 - CamtVersionNotSupported: Die im XML-Dokument angegebene CAMT-Version wird nicht unterstützt.
ERR-02-0034 - InvalidValue: Ein Feld im übertragenen JSON- oder XML-Dokument enthält einen ungültigen Wert.
ERR-02-0035 - OtherPartyAddressRequired: Für Zahlungsvorgänge außerhalb der EU mit einem Betrag > 1.000 € muss die Adresse angegeben werden.
ERR-02-0036 - DeprecatedLocalInstrument: Die Datei enthält den nicht unterstützten Lastschrifttyp „COR1“. Erlaubt sind nur „CORE“ und „B2B“. Die automatische Umwandlung von „COR1“ in „CORE“ kann in den API-Einstellungen aktiviert werden.
ERR-02-0037 - InvalidLocalInstrument: Die Datei enthält einen ungültigen Wert im Feld „LocalInstrument“ für diese Zahlungsart.
ERR-02-0038 - PaymentMessageIsNotUnique: Die Message-ID der Zahlungsdatei muss eindeutig sein. Diese optionale Prüfung kann in den API-Einstellungen deaktiviert werden.
ERR-03-XXXX – Kategorie: Inhalt nicht lesbar
ERR-03-0001 - NoContentReceived: Es wurde kein Inhalt übertragen.
ERR-03-0002 - InvalidContentType: Der angegebene Content-Type des 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 keinem wohlgeformten XML-Dokument.
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 Rückerstattungsinformationen ist ungültig.
ERR-03-0008 - ContentNotReadable: Die übertragene Text-, JSON- oder XML-Datei entspricht nicht der erwarteten Struktur.
ERR-04-XXXX – Kategorie: Voraussetzungen nicht erfüllt
ERR-04-0001 - MissingScope: Der für die Authentifizierung verwendete API-Schlüssel verfügt nicht über die erforderlichen Berechtigungen, um auf die angeforderte Ressource zuzugreifen.
ERR-04-0002 - SrzMappingFailed: Die Bestimmung des Service-Rechenzentrums für die Übermittlung 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 verfügt nicht über den für den Zahlungstyp erforderlichen Ordertyp.
ERR-04-0005 - InvalidEbicsContact: Der EBICS-Kontakt für die Übertragung der Zahlungsdatei ist nicht vollständig initialisiert oder nicht zur Übertragung von Zahlungen konfiguriert.
ERR-04-0006 - InvalidPaymentStatus: Der Status der Zahlung ist bereits auf „executed“ gesetzt. Eine erneute Ausführung ist nur möglich, wenn der Parameter
forceauf „true“ gesetzt ist.ERR-04-0007 - BankAccountIbanAlreadyExists: Ein Bankkonto mit der angegebenen IBAN und Währung existiert bereits.
ERR-04-0008 - InactiveBankAccount: Das Bankkonto ist 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 Rückerstattungstransaktion ist nicht eindeutig.
ERR-04-0011 - DuplicateFound: Die Datei wurde als Duplikat erkannt.
ERR-04-0012 - IndividualRestriction: Die Zahlungsdatei kann aufgrund einer individuellen Einschränkung der Bank nicht akzeptiert werden.
ERR-04-0013 - ClientBlocked: Die Client-Anwendung wurde von konfipay gesperrt. Weitere Informationen zur genauen Ursache finden sich in den Fehlerdetails.
ERR-04-0014 - InsufficientPermissions: Der Client ist nicht berechtigt, die angeforderte Aktion auszuführen. Weitere Informationen zur genauen Ursache finden sich in den Fehlerdetails.
ERR-05-XXXX – Kategorie: Verarbeitungsfehler
ERR-05-0000 - ProcessingError: Während der Verarbeitung der Anfrage ist ein Fehler aufgetreten. Weitere Informationen zur genauen Ursache finden sich in den Fehlerdetails.
ERR-05-0001 - EbicsError: Beim Ausführen der EBICS-Aktion ist ein Fehler aufgetreten.
ERR-05-0002 - PayPalError: Beim Ausführen der PayPal-Aktion ist ein Fehler aufgetreten.
ERR-05-0003 - PayPalUnspecifiedError: Während der Ausführung der PayPal-Aktion ist ein Fehler aufgetreten, der von PayPal nicht näher spezifiziert wurde.