Error messages occasionally occur due to a faulty file structure or more often due to missing bank authorizations. More rarely, connection interruptions or general transmission errors to the bank server are the cause. konfipay contains a sophisticated warning and notification system for this purpose.
konfipay has an error detection function that checks the submitted payment file for formal errors and thus ensures that this file does not reach the bank in the first place. A finely tuned duplicate check by konfipay also avoids potential duplicate submissions.
Below you will find a list of error codes that can occur during synchronization with the konfipay Online Payment Services API. Errors can be read via the
- Nummer des Fehlers. Die Nummer ist innerhalb ihrer Kategorie eindeutig.
ERR-01-XXXX - Category: Invalid string parameter |
ERR-01-0001 | RIdNotFound | There is no resource for the given RId. |
ERR-01-0002 | MsgIdNotFound | There is no resource for the given message identification. |
ERR-01-0003 | AmbiguousMsgId | The given message identification is ambiguous. |
ERR-01-0004 | InvalidStartDate | The start date was not recognized as valid date. |
ERR-01-0005 | InvalidEndDate | The end date was not recognized as valid date. |
ERR-01-0006 | InvalidPeriod | The given period is not valid (the start date and end date have to be chronological). |
ERR-01-0007 | InvalidDate | The date was not recognized as valid date. |
ERR-01-0008 | TransactionIdNotFound | There is no resource for the given transaction id. |
ERR-01-0009 | InvalidTransactionId | The given transaction id is invalid (empty or mor than 19 characters). |
ERR-01-0010 | AmbiguousTransactionId | The given transaction id is ambiguous. |
ERR-01-0011 | EMailAddressOrMerchantIdNotFound | There is no resource for the given email or merchant id. |
ERR-01-0012 | MissingParameter | A required parameter is not set. |
ERR-01-0013 | BankNotFound | The requested bank was not found. |
ERR-01-0014 | InvalidGateway | The requested gateway is not supported. Only "SRZ", "EBICS" or a valid rId are allowed. |
ERR-01-0015 | UnsupportedApiVersion | The API version is not supported for the requested resource. |
ERR-01-0016 | InvalidQueryStringValue | The query string parameter contains an invalid value. |
ERR-02-XXXX - Category: Content validation failed |
ERR-02-0000 | ontentValidationFailed | The validation of the content failed. More information about the exact reason can be found in the error details. |
ERR-02-0001 | InvalidRId | The given RId is invalid (empty or not 36 characters long). |
ERR-02-0002 | InvalidXmlCharacter | The file contains invalid characters according to the DFÜ agreement. |
ERR-02-0003 | MissingXmlNamespace | The XML document does not contain a valid XML namespace |
ERR-02-0004 | InvalidXmlNamespacePrefix | The XML namespace prefix is invalid. |
ERR-02-0005 | PainVersionNotSupported | The specified pain version is not supported by konfipay. |
ERR-02-0006 | PainVersionReleaseDateNotReached | The pain version specified in the XML document is not (yet) valid. |
ERR-02-0007 | SchemaValidationError | The validation of the XML document against the XML schema failed. |
ERR-02-0008 | InitPartyIbanChecksumValidationFailed | The IBAN checksum of the ordering party account is invalid. |
ERR-02-0009 | OtherPartyIbanChecksumValidationFailed | The IBAN checksum of a beneficiary/payee account is invalid. |
ERR-02-0010 | InvalidIbanIsoCountryCode | The ISO country code contained in the IBAN is invalid or not supported. |
ERR-02-0011 | TransactionLimitExceeded | The maximum number of transactions allowed per payment order was exceeded. |
ERR-02-0012 | LocalInstrumentMashup | The document contains more than one payment method. |
ERR-02-0013 | InvalidServiceLevel | The specified service level is invalid (urgent payments are not allowed). |
ERR-02-0014 | InvalidExecutionDate | The execution date is too far in the future/past. |
ERR-02-0015 | InvalidInitiatingPartyIban | The bank account is not assigned to the user account or is inactive. |
ERR-02-0016 | IbanBicMismatch | The bank code of the IBAN does not match the BIC of the financial institution. |
ERR-02-0017 | ControlSumMismatch | The specified checksum in the header or a payment does not match the content. |
ERR-02-0018 | NumberOfTransactionsMismatch | The specified number of transactions in the header or a payment does not match the content. |
ERR-02-0019 | InvalidOtherPartyCountry | The beneficiary/payer bank account is not located in a SEPA participating country. |
ERR-02-0020 | InvalidBankAccountIban | The checksum of the IBAN of the bank account is invalid. |
ERR-02-0021 | InvalidBankAccountAdditionalInformation | The content exceeds the maximum length of 500 characters. |
ERR-02-0022 | InvalidCreditorId | The structure of the creditor identification is invalid. |
ERR-02-0023 | MissingRefundIdentifier | No identifier was specified for the transaction (transaction id or RId). |
ERR-02-0024 | InvalidRefundMemo | The memo specified for the refund is invalid (max. 255 characters). |
ERR-02-0025 | InvalidRefundType | The specified refund type is invalid. Possible refund types: Full | Partial | td>
|
ERR-02-0026 | MissingRefundAmount | The amount to be refunded is required but not specified. The amount is required if refundType specified with Partial. |
ERR-02-0027 | InvalidRefundAmountValue | The value of the amount to be refunded is invalid. |
ERR-02-0028 | InvalidRefundAmountCurrency | The currency of the amount to be refunded is invalid. |
ERR-02-0029 | DtazvValidationFailed | The validation of the DTAZV file has failed. |
ERR-02-0030 | IbanValidationFailed | The validation of the IBAN has failed. |
ERR-02-0031 | InvalidBlz | The bank code is invalid. |
ERR-02-0032 | ContainerVersionNotSupported | The container version specified in the XML document is not supported. |
ERR-02-0033 | CamtVersionNotSupported | The camt version specified in the XML document is not supported. |
ERR-02-0034 | InvalidValue | A field in the transferred Json or XML document has an invalid value. |
ERR-02-0035 | OtherPartyAddressRequired | For payment orders whose counter account is not located in an EU participating country and with an amount > 1000€, it is mandatory to provide the address. |
ERR-02-0036 | DeprecatedLocalInstrument | The file contains the unsupported direct debit type "COR1". Only "CORE" and "B2B" are supported. "COR1" can be automatically converted to "CORE" using the API settings. |
ERR-02-0037 | InvalidLocalInstrument | The file contains an invalid value for this payment type in the 'LocalInstrument' field. |
ERR-02-0038 | PaymentMessageIsNotUnique | The Message ID of the payment file needs to be unique. This is an optional check that can be deactivated in the API settings. |