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 Code | Description |
|---|---|
| GENERAL_ERROR | This is a common error code used for unexpected error states. Bank should be contacted for help in most cases. |
| Client | Error 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_DATA | Incorrect 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_ACTIVE | This error code is returned in case user is not active and therefore cannot use the DBI channel. |
| USER_IS_BLOCKED | This 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_CHANGED | This error code is returned in case user must change password. (see Password Change Documentation) |
| SECURITY_POLICIES_NOT_MET | During 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_CREDENTIALS | This error code is returned in case incorrect user name or password is provided and authentication fails. |
| OTP_FAILED | This 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_AUTHORIZED | This error code is returned in case user has no right to perform requested operation (e.g. to import payment order). |
| DUPLICATED_SINGLE_PAYMENT_REQUEST | This 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_REQUEST | This 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_FOUND | This 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_FOUND | This 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 Rejected | This 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. |
Updated over 1 year ago