Error Handling

This chapter defines error codes and their meaning. All errors are propagated to client systems as SOAP fault messages defined in corresponding standard.

๐Ÿšง

There should be no whitespaces in the request body

If there is any whitespace in the request, especially if the very first character is space, request will be rejected.

Soap Fault Codes

Fault CodeDescription
GENERAL_ERRORThis is a common error code used for unexpected error states. Bank should be contacted for help in most cases.
ClientError code generated by automatic validation systems (e.g. by schema validator). Try to check documentation and examples of usage. (i.e. one or more tag is missing from request body)
INCORRECT_INPUT_DATAIncorrect input data error code means that incorrect data was sent to the system. Try to check documentation and examples of usage. (i.e.: a: Maximum allowed number of single payment orders has been exceeded or b: Position element is not unique.)
USER_IS_NOT_ACTIVEThis error code is returned in case user is not active and therefore cannot use the DBI channel.
USER_IS_BLOCKEDThis error code is returned in case user is in a blocked state (e.g. is temporarily blocked due to too many unsuccessful login attempts).
CREDENTIALS_MUST_BE_CHANGEDThis error code is returned in case user must change password. (see Password Change Documentation)
SECURITY_POLICIES_NOT_METDuring password change this error can be returned in case new password does not match the criteria specified by bank. (see Password Policy)
This error can be returned also in case client is required to use digital certificate, but tries to establish connection without it.
INCORRECT_CREDENTIALSThis error code is returned in case incorrect user name or password is provided and authentication fails.
OTP_FAILEDThis error code is returned in case provided OTP, generated by digipass token. is invalid, is expired or is not supplied at all. In some cases, wrong digipass device is used (Internet banking interface has it's own dedicated digipass token)
NOT_AUTHORIZEDThis error code is returned in case user has no right to perform requested operation (e.g. to import payment order).
DUPLICATED_SINGLE_PAYMENT_REQUESTThis error code is returned in case web service ImportSinglePaymentOrders or web service ImportBatchPaymentOrder is called and there is already imported single payment order with the same request ID for the same client.
DUPLICATED_BATCH_PAYMENT_REQUESTThis error code is returned in case web service ImportBatchPaymentOrder is called and there is already imported batch payment order with the same request ID for the same client.
SINGLE_PAYMENT_REQUEST_NOT_FOUNDThis error code is returned in case web service GetSinglePaymentId is called and specified single payment request ID is not found for a given client.
BATCH_PAYMENT_REQUEST_NOT_FOUNDThis error code is returned in case web service GetBatchPaymentId is called and specified batch payment request ID is not found for a given client.
Request RejectedThis error code is returned in case XML body structure is invalid. Use any xml validator tool.
In some cases, this error occurs when there are whitespaces in the request body.