Skip to main content

Response Codes

General Response Codes

CodeDescription
0000Successful execution.
0001One or more of the required fields have not been sent or some fields were not in a correct format: { list of all required or incorrect fields }.
0002Invalid '{parameter name}' supplied.
0003'amount' should be greater than 0.00.
0004The program does not have configured program payment provider settings for the used payment option.
0006External payment provider failed to process the operation.
0007'{parameter name}' must not be empty.
0011Invalid status supplied in '{parameter name}'.
0012'{parameter name}' is already in use for the program.
0013'{parameter name}' is already in use for the portal.
0014'mandateReference', 'mandateSignedDate' and 'mandateSignedTime' are required for payment option "Bank Account SEPA".
0015Payment status is different from 'Authorized'.
0016The Transaction found by provided 'uniqueReference' is involved into the Deal with "Delayed Shipment" Type and Payment status is different from 'Expired' or 'Authorized'.
0017Corresponding account type is inactive.
0018Unknown user.
0019User is inactive.
0020User is locked.
0021Unknown 'transactionTypeCode'.
0022Unknown 'paymentOptionCode'.
0023Unknown currency code.
0024'mandateReference', 'mandateSignedDate' and 'mandateSignedTime' must be empty for payment options different from "Bank Account SEPA".
0026Maximum value of the '{limit name}' limit is exceeded.
0027Invalid country code supplied in: '{parameter name}'.
0028Country supplied in the 'countryCode' is not supported.
0029Specified 'programAccno' is not a program account.
0030Invalid 'fileId'.
0031Specified '{parameter name}' is not an e-wallet user account.
0032Unknown 'paymentGroupCode'.
0033Unknown 'paymentSubGroupCode'.
0034'{parameter name}' is already in use for the account.
0035Payment status is different from 'Received'.
0036Current account application status does not allow file uploading or deleting.
0037Specified '{parameter name}' is not a merchant account.
0038Digital signature of the payment provider response is incorrect.
0039The file size must be less than or equal to 10 MB.
0040Program account has insufficient funds: {program account number}.
0041User password is expired.
0043Using of the stored payment option is denied, because it is in the "Pending" status.
0044'{Parameter Name}' array contains duplicated items.
0045Using of the stored payment option is denied, because it is in the "Pending" or "Blocked" status.
0046If 'useDifferentBillingAddress' is true, 'customerFullName', 'addr1', 'city', 'countryCode', 'postCode' must be provided.
0047Database connection timeout.
0048Unknown '{parameter name}'.
0049Status of transaction specified by 'uniqueReference' is different from "Authorized".
0050Transaction specified by 'uniqueReference' has already got a dependent transaction of transaction type category "Load Account".
0051Minimum value of the '{limit name}' limit is exceeded.
0052Payer's account has insufficient funds: {account number}.
0055Failed to get order data from Debtor Management Provider.
0056Payment status is different from 'Received', 'Authorized' or 'Capture in Progress'.
0057The file is empty.
0058Server is currently busy. Please try again.
0060Account is inactive: {account number}.
0061Merchant is inactive: {the name of corresponding Account Owner}.
0063Integration settings have not been set up: { compliance check settings | location check settings | risk check settings | vat id check settings | address autocompletion check settings | blacklist filter settings | debtor management settings}.
0064'X-Access-Token' is not a valid JWT Token.
0065User Agreement Text is not found by specified 'userAgreementReference'.
0066Value must be > 0: '{parameter name}'.
0067Specified merchant account has a currency different from the specified '{parameter name}'.
0068The operation is denied for this user: not enabled through API Authorization Sets.
0069The operation is denied for this user: {system operation code}.
0070The uploaded file content does not match the file extension.
0071Provided stored payment option has exceeded its validity period.
0073Account's maximum balance would be exceeded as a result of this transaction: {account number}.
0074Specified 'programAccno' has a currency different from the transaction currency.
0075Specified 'accno' has a currency different from the transaction currency.
0077Failed to convert currency.
0078Corresponding payment option is inactive for: {account number}.
0079Corresponding transaction type is inactive for: {account number}.
0080Account is expired: {account number}.
0081The file name length must be less than or equal to 255 characters.
0082Merchant account has insufficient funds: {merchant account number}.
0083Specified 'accno' is neither an e-wallet user account nor merchant account.
0084Specified 'accno' is an e-wallet user but the provided stored payment option is not associated to him/her.
0085For the country "{Country name}" parameter '{parameter name}' is required.
0086Transaction settlement failed, transaction is created in the "Captured" status.
0088Incorrect file extension. Supported file extensions are jpg, jpeg, png, pdf, doc, docx.
0089Mandate reference must be unique for the program.
0090The provided value in '{parameter name}' is incorrect state name or code.
0091Transaction specified by '{parameter name}' must have transaction type category "Deposit".
0092Transaction specified by 'uniqueReference' must have transaction type category "Payment".
0095Specified stored payment option has an associated payment provider different from "PAY.ON", "PAY.ON with PCI Proxy", "CyberSource", "CyberSource with TokenEx", "PayPal", "SEPA", "Virtual Payment Provider" or "Vesta with TokenEx".
0096Authorization has been denied for this request.
0097Payload has an incorrect format.
0098Concurrency error occurred.
0099Unexpected server error occurred.
1431The specified {amount} does not satisfy the currency minor unit.
1432The specified {amount} is less than the currency minimum allowed value.
9001BIN check service failed to perform the operation.
9002The 'criteria' request parameter with name '{parameter name}' is not a valid fully-qualified https URL.
9005Only "EUR" can be used with provided "Bank Account SEPA" payment option.
9006Virtual payment provider is used, 'criteria' request parameter with the following name must be provided: '{parameter name}'.
9007A payment option of payment group "Cards" is used with Virtual payment provider, 'criteria' request parameters with names "bin", "last4digits", "expiryMonth" and "expiryYear" must be provided.
9008A payment option of payment group "Banks" is used with Virtual payment provider, 'criteria' request parameters with names "bankAccount" and "bankCode" must be provided.
9009Virtual payment provider is used, 'criteria' request parameter with name "carrierNumber" must be provided.
9010The 'criteria' request parameter with name "origin" is not a valid comma-separated list of fully qualified origins (only HTTPS scheme, domain name or IP address and optional ports are allowed for each origin, every URL in origin chain must not have a trailing slash).
9011A payment option of payment group "Cards" is used with Virtual payment provider in guest payment mode, 'criteria' request parameter with name "guestPaymentOptionToken" must be provided.
9012Duplicated 'name' field values of 'criteria' exist.
9013The payment option of payment group "Cards" used with Virtual payment provider must not be expired (the last day of the month and the year specified by 'criteria' request parameters with names "expiryMonth" and "expiryYear" must not be in the past).
9014For Third Party Provider's requests of this API method 'accno' must belong to an e-wallet user.
9015The requested URL resource does not support the provided HTTP request method.
9017Either '{the first parameter name}' or '{the second parameter name}' parameter must be provided.
9018A payment option of payment group "Cards" is used with Virtual payment provider, 'criteria' request parameter with name "storedPaymentOptionReference" must be provided.
9019Financial operations between CPSP and non-CPSP merchants are prohibited.
9020Financial operations between E-Wallet users and CPSP merchants are prohibited.
9998Request cancelled because of internal time-out.
9999Request cancelled or timed-out.

'Create Account' and 'Update Account Information' Response Codes

CodeDescription
0101'externalAccountReference' already in use.
0102'loginID' already in use.
0103Specified 'accountApplicationFlowCode' is not applicable for an E-Wallet User Account.
0104Cannot use an email address as 'loginID'.
0105The user has not achieved the minimum allowed age.
0106Unknown 'accountApplicationFlowCode'.
0107Specified 'accountApplicationFlowCode' is inactive.
0108Password does not comply to the password policy: '{password policy description}'.
0109Account currency specified by 'currCode' is not allowed for user boarding.
0110'externalAccountReference' must be specified.
0111'externalAccountReference' must not be specified.
0130Invalid '{parameter name}' value.
0131Invalid 'timeZone' value.
0132A business user field is provided to a non-business user.
0133On account {"creation"|"update"} the 'externalAccountReference' may not be empty string.
0134The combination of KYC fields is not unique for the program.
0135Unknown 'accTypeCode'.
0136Specified 'accTypeCode' is not allowed for accounts.
0137Specified 'accTypeCode' does not correspond to E-Wallet User Category.
0138Compliance Check failed, the Account cannot be created.
0139Account application in processing due to compliance check.
0140Specified 'accTypeCode' is not active.
0141Account has not been created/updated: debtor is not maintained.
0142Specified 'userAgreementReference' is not found for the Program.
0143Specified 'userAgreementReference' is expired or not valid yet.
0144User agreement text of the account is not valid.
0145User agreement text of the account owning the specified 'storedPaymentOptionReference' is not valid.
0146Account application in processing due to fraud monitoring.
0147The expiration date of the identity document must not be in the past.

'Change Status' Response Codes

CodeDescription
0120Account already in the desired status.
0121Cannot change status to "Closed" or "Rejected".
0122Cannot activate the user account, because the corresponding program account is inactive.
0123Cannot change status from "Closed" or "Rejected".

'Account Enquiry', 'Pending Transactions Enquiry' and 'Dealer Funding Enquiry' Response Codes

CodeDescription
0160'{parameter1 name}' is greater than '{parameter2 name}'.

'Load Account' Response Codes

CodeDescription
0177The Transaction found by the specified 'uniqueReference' is involved into the Deal with "Delayed Shipment" Type and has status different from "Expired", "Captured" or "Settled".
0179Transaction found by the specified 'uniqueReference' has a currency different from the load currency.
0180Account load limit exceeded.
0181'loadAmount' should be greater than 0.00.
0182Program load limit exceeded.
0183'loadAmount' value exceeds the 'presentationAmount' of the transaction found by the specified 'uniqueReference'.
0184Cannot add a "Load Account" transaction to a group containing a "Payment" transaction.
0185Transaction found by the specified 'uniqueReference' must have either a single dependent transaction having "Init Load Account" transaction type and "Capture In Progress" status or no dependent transaction having "Load Account" transaction type category.
0186Current deposit has adjusted Settled Amount, '{loadAmount | paymentAmount}' and '{loadCurrCode | paymentCurrCode}' should match the deposit presentation amount and presentation currency and only one "{Load Account | Payment}" transaction can be added.
0188'loadAmount' should be greater than 0.00 and less than or equal to initiated load amount.
0189Transaction found by the specified 'uniqueReference' is neither in captured status, nor in settled status.

'Unload Account' Response Codes

CodeDescription
0190Account unload limit is exceeded.
0191'unloadAmount' should be greater than 0.00.
0192Account has insufficient funds: {account number}.
0194Specified 'paymentOptionCode' is not available for unloading this account.
0195Program unload limit exceeded.

'Init Authorize' Response Codes

CodeDescription
0223Criteria item with name = "redirectUrl" must be provided and its value must not be empty.
0224Provided stored payment option must belong to payment group "Cards".
0225Specified stored payment option has an associated payment provider different from "PAY.ON", "PAY.ON with PCI Proxy" and "Virtual Payment Provider".
0226'storedPaymentOptionReference' and 'paymentOptionCode' parameters must match the same payment option.
0227SCA mode is disabled. 'storedPaymentOptionReference' must not be provided.

'KC-Capture' and 'Capture' Response Codes

CodeDescription
0230'modifiedAmount' should be greater than 0.00 and less than or equal to authorized amount.
0233Transaction found by the specified 'uniqueReference' has a currency different from the capture currency.
0234Transaction found by the specified 'uniqueReference' is a "KC-Block" transaction.
0235'modifiedAmount' should be equal to authorized amount if {"PaymentsOS" | "Prepayment"} payment provider is used.

'KC-Cancel' and 'Cancel' Response Codes

CodeDescription
0240Cancelling is not supported for the used payment option.
0241Cancellation period for the selected transaction has exceeded.

'KC-Refund' and 'Refund' Response Codes

CodeDescription
0250Payment status is different from 'Captured' or 'Settled'.
0251A refund, a chargeback or a reject was performed for the referenced transaction.
0252Transaction specified by 'uniqueReference' must have transaction type category "Load Account" or "Payment".
0253Account has insufficient funds: {account number}.
0254'refundAmount' must be greater than 0.00 and less than or equal to amount available for refund: {amount which is calculated according to certain description of the validation}.
0256Refund is not supported for the used payment option.
0257Transaction found by the specified 'uniqueReference' has a dependent transaction of transaction type "KC-Block" and status "Authorized" or "Received".
0258Transaction specified by the 'uniqueReference' is not refundable.
0852Transaction specified by the 'uniqueReference' was created more than {"Transaction Policy"-> "Refund Period In Days"} days ago.
0853'refundAmount' should complete already refunded amounts to the full amount available for refund.
0855Transaction found by specified 'uniqueReference' is performed with "SofortÜberweisung" or "IDEAL" payment option, a valid IBAN is not available.
0856Transaction found by specified 'uniqueReference' is performed with "SofortÜberweisung" or "IDEAL" payment option, active payment provider settings of type "SEPA" are not available.
0857Transaction found by the specified 'uniqueReference' has a related order.
0858A transaction specified by 'uniqueReference' is linked to a {"B2B Dealer Order"|"B2C Voucher Order"}, operation is denied.
0859Only Single Transaction Refund can be applied for the specified transaction.
0860Only Full Chain Refund can be applied for the specified transaction.
0861Only Partial Chain Refund or Full Chain Refund can be applied for the specified transaction.
0865Amount of the refunding transaction must be equal to Amount of the refunded transaction.
0866Only Single Transaction Refund or Full Chain Refund can be applied for the specified transaction.
0867Amounts of "Deposit" and "Load Account" transactions are not equal, only Full Chain Refund for the full amount can be applied for the specified transaction.
0870{ "Dependent external transaction of transaction found by provided 'uniqueReference' "

'Find User Account' Response Codes

CodeDescription
0260Specified user does not have an account in the specified program.

'Get Applicable Limits' and 'Check Limits' Response Codes

CodeDescription
0320Unsupported combination of input parameters is used. Please use one of the following: 1. 'transactionTypeCode' and 'paymentOptionCode' and 'storedPaymentOptionReference' are not provided; 2. 'transactionTypeCode' and 'paymentOptionCode' are provided; 3. 'transactionTypeCode' and 'storedPaymentOptionReference' are provided; 4. 'transactionTypeCode' is provided.
0321Either 'paymentOptionCode' or 'storedPaymentOptionReference' or none of them must be specified.
0322'isVerified' is required, if 'paymentOptionCode' is provided.

'Authorize' and 'Pay to Account' Response Codes

CodeDescription
0361If 'accno' is not specified 'emailAddress' must be passed with "{currently used payment provider}" payment provider.
0362Compliance Check hit, transaction cannot be processed.
0363'presentationAmount' should be greater than 0.00.
0366Actual billing address must be passed for PayPal tracking, if 'accno' is a merchant account.
0367Actual payer's billing address must be passed, if a payment is done to a merchant via PayPal.
0368'emailAddress' must be passed, if a payment is done via "PayPal" and 'accno' is not specified or belongs to a merchant.
0369If 'accno' is not provided, 'useDifferentBillingAddress' must be true.
0370The provided stored payment option is not associated with the provided 'accno'.
0401Account owning the specified 'storedPaymentOptionReference' is not active.

'Get Countries' Response Codes

CodeDescription
0410'programCode' is provided, 'onlyProgramCountries' must also be provided.

'Complete Authorize', 'KC-Authorize' and 'KC-Debit Account' Response Codes

CodeDescription
0220'paymentAmount' should be greater than 0.00.
0475"{currently used payment provider}" payment provider is used, the 'criteria' request parameter with name "paymentProviderResponse" or "isStatusRequest" must be provided.
0476"{currently used payment provider}" payment provider is used and no stored payment option is defined, the 'criteria' request parameter with name "paymentProviderResponse" or "isStatusRequest" must be provided.
0477Provided 'paymentProviderResponse' does not match the provided 'authorizationToken'.
0478Virtual payment provider is used, 'criteria' request parameter with name "paymentOptionCode" must be provided.
0479Current deposit is performed via Prepayment and already has a dependent Payment transaction.
0480Invalid 'authorizationToken'.
0481"PayerID" must be provided under 'criteria' request parameter, if PayPal payment provider is used.
0482Transaction is pending on payment provider.
0483Pooling is not enabled for the account specified by 'accno'.
0484'programAccno' doesn't match the Account of the transaction found by {'uniqueReference' | 'depositReference'}.
0488Status of transaction specified by 'depositReference' is different from "Captured" or "Settled".
0489Transaction found by the specified 'depositReference' already has a dependent transaction having "Payment" transaction type category.
0490Payee differs from the add money beneficiary.
0491Unsupported 'paymentBrand' in payment provider response.
0493{'merchantAccno' | 'accno'} is specified as External Account Reference, the {'merchantProgramCode' | 'programCode'} is required.
0494Payment option was not defined for "Init Authorize". Payment option received from the payment provider must belong to payment group "Cards".
0495Storing a payment option was selected by the user during payment data input. This is forbidden for merchant accounts.
0496Payment option returned by the payment provider does not match the payment option specified in the {"Init Authorize" | "Init Add Stored Payment Option"} request.
0497The specified 'accno' must have an unexpired default stored payment option.
0498The sum of amounts of all dependent payment transactions exceeds the amount of the transaction found by the specified 'depositReference'.
0499'paymentAmount' should be equal to the authorized amount if the transaction found by the specified 'uniqueReference' has a related order.
0500For Third Party Provider's requests of this API method 'accno' must belong to an e-wallet user and 'depositReference' must not be provided.

'Issue Token' Response Codes

CodeDescription
0018The user with the specified 'userId' and 'password' must exist for the WebAPI Portal and must not be locked.
0019The user with the specified 'userId' must be active.
0041The password of the user with the specified 'userId' must not be expired.

2FA Response Codes

CodeDescription
0550The user has "{the user 2FA status}" 2FA status which is not supported. Supported statuses: {the list of comma-separated 2FA statuses (each of them in quotes)}.
0551The user Portal does not support Two-Factor Authentication.
0552The One-Time Password request is blocked due to too many requests.
0553The repeated One-Time Password request is blocked due to too many requests.
0554The Mobile Phone, required to configure 2FA, is not specified for the user or is not valid.
0555The configuration of 2FA has not been completed.
0556Confirmation with 2FA is required. 'oneTimePassword' must be provided (use the value sent to the user via SMS).
0557'oneTimePassword' parameter must be a {"Digits" parameter from current version of 2FA KC Algorithm}-digit number.
0558'oneTimePassword' is incorrect.
0559An incorrect 'oneTimePassword' is provided for {" Max Unsuccessful 2FA Attempts" setting value} times. Corresponding user has been locked.
0560Confirmation with a verification code is required. 'twoFASetupCode' must be provided (use the value sent to the user email address).
0561'twoFASetupCode' is incorrect.
0562An incorrect 'twoFASetupCode' is provided for {" Max Unsuccessful 2FA Attempts" setting value} times. Corresponding user has been locked.
0563The verification code which has been sent to the user email address is expired.
0564The one-time password which has been sent to the user via SMS is expired.
0571An error occurred during external call to SMS provider.
0572An error occurred while sending an SMS by an external provider.
0573The phone number provided as '{parameter name}' request parameter is not valid.

'Add Stored Payment Option', 'Init Add Stored Payment Option', 'Complete Add Stored Payment Option' and 'Delete Stored Payment Option' Response Codes

CodeDescription
0620'paymentOptionCode' is not storable.
0621Specified 'paymentProvider' is not applicable for an E-Wallet User Account.
0623An error occurred while registering a payment option with an external provider.
0625The 'criteria' request parameter with name "callbackURL" is required with "{currently used payment provider}" payment provider
0626"returnURL" and "cancelURL" must be provided under 'criteria' request parameter, if PayPal payment provider is used.
0628Pooled transactions exist for the specified account, a default stored payment option cannot be deleted.
0629Specified payment option does not match the payment option defined in the "Init Add Stored Payment Option" request.
0630If different billing address is used 'emailAddress' must be passed with "{Payment Provider Name}" payment provider.
0631The specified 'storedPaymentOptionReference' is used for payout in the deferred account closing and cannot be deleted.
0632The 'criteria' request parameter with 'name'="paymentProviderResponse" is required with "{currently used payment provider}" payment provider.
0633'paymentOptionCode' must refer to payment group "Banks" or "Cards" or payment option "PayPal", "Apple Pay" or "Google Pay".
0634Another account has stored payment option with the same reference and currently used payment provider.
0635Only "EUR" can be used as currency with provided "{currently used payment provider}" payment provider.
0636Payment option with the same 'storedPaymentOptionReference' has already been added to the account: {accno}.
0638Virtual payment provider is used, 'paymentOptionCode' is required.
0639"{currently used payment provider}" payment provider is used and 'criteria' request parameter with name "isStatusRequest" is not provided, the 'criteria' request parameter with name "redirectUrl" must be provided.
0640Invalid payment provider type.
0642"{currently used payment provider}" payment provider is used and 'criteria' request parameter with name "isStatusRequest" is provided, the 'criteria' request parameters with names "panToken" and "initiatedTransactionReference" must be provided.
0644No stored payment option is found by the provided 'authorizationToken'.
0645Status of the stored payment option found by the provided 'authorizationToken' is not "Pending".
0691'bankCode' parameter is not provided.

'Init Verify Stored Payment Option' and 'Complete Verify Stored Payment Option' Response Codes

CodeDescription
0660'storedPaymentOptionReference' is not verifiable.
0661'storedPaymentOptionReference' is not in "Unverified" status.
0662Verification code is incorrect.
0663Verification code is incorrect. And the amount of allowed verification attempts is exceeded. Stored payment option returns to the Unverified status.
0665Specified card is expired.
0666The specified 'accno' and 'programAccno' have different currencies.
0669'storedPaymentOptionReference' is not in "In Verification" status.
CodeDescription
0830Account application is in an incorrect status for a transition to the 'Closed' status.
0831There is no balance to be paid out to the specified stored payment option.
0832The specified 'accno' cannot be closed, because it is already scheduled for closing.
0833'storedPaymentOptionReference' parameter is required to perform payout when closing the account, if available balance of this account is greater than 0.
0834The owner of the account corresponding to the provided 'accno' already has a request to delete the sensitive data.
CodeDescription
0950A SEPA mandate can be only downloaded for the "Bank Account SEPA" payment options.
0951Mandate data is not available for the specified stored payment option.

'Perform Person Compliance Check', 'Perform Company Compliance Check', 'Perform Person Risk Check' and 'Perform Company Risk Check' Response Codes

CodeDescription
1090Compliance provider failed to perform the operation.
1091KontoCloud payment option code cannot be mapped to the provider payment option code.
1092Risk Check provider failed to perform the operation.
1094The request must contain either 'storedPaymentOptionReference' or 'useDifferentBillingAddress' = true, 'customerFullName', 'addr1', 'city', 'postCode' and 'countryCode' or both.

'Perform Address Check' Response Codes

CodeDescription
1130Address check provider failed to perform the operation.

'VAT ID' Response Codes

CodeDescription
1140VAT ID provider failed to perform the operation.

'Perform Address Auto Completion' Response Codes

CodeDescription
1210Address auto completion provider failed to perform the operation.

'Perform Compliance Callback' Response Codes

CodeDescription
1220Specified compliance results not found.
1221Specified 'archiveId' does not support manual review.
1222Specified compliance result corresponds to a closed or rejected account.
1223Manual Review Result cannot be set for inspected compliance check.
1224Manual Review Result is already defined for the compliance result found by specified 'archiveId'.

'External Id' Response Codes

CodeDescription
1250Specified Program's ID Provider not configured.
1251Provided UUID is already in use in the combination with the provided ID Provider in the specified Program.
1252Provided UUID not found for the provided 'accno' in the specified Program.
1253Only one UUID of the external ID Provider can be added for the user.
1254Last user's UUID cannot be deleted.

'Get User Agreement Text' and 'Get Current User Agreement Text' Response Codes

CodeDescription
1260Current user agreement version is not found.
1261Current user agreement text is not found.
1262Either 'userAgreementReference' or 'culture' must be specified.

'KC-Block', 'KC-Unblock' Response Codes

CodeDescription
1330If 'refundAmount' is true, the transaction defined by 'uniqueReference' must have a dependent deposit transaction.
1331Transaction found by the specified 'uniqueReference' is not a "KC-Block" transaction.
1332Transaction found by the specified 'depositReference' already has a dependent transaction of transaction type category "Payment".
1333Transaction found by 'depositReference' does not have associated stored payment option.

Response Codes for headers validation

CodeDescription
2010If the resolved program payment provider settings refers to "PaymentsOS" payment provider, 'X-Ip-Address' header must be specified.