Search

Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Error codes

Learn about error codes and what they mean.

This page contains codes and descriptions of all errors that may occur when you communicate with the Platforms API.

If after reading this section you are still not sure how to interpret a specific error, contact the Support Team.

General error codes

These are the common error codes, which may be returned when you communicate with Adyen for Platforms:

Error code Description
10_001 Internal timeout
10_002 Internal error: message='{0}'
10_003 Failed to authorize user
10_004 Account with accountCode='{0}' does not exist
10_005 Account already exists: accountCode='{0}'
10_006 Failed to create account: accountCode='{0}'
10_007 Failed to create account: accountCode='{0}'; message='{1}'
10_008 Invalid accountCode: accountCode='{0}'; pattern='{1}'
10_009 Invalid email address: '{0}''
10_010 Account with accountCode='{0}' has already been closed
10_011 Failed to close account: accountCode='{0}'
10_012 Invalid account type: accountCode='{0}', type='{1}', expected='{2}'
10_013 Failed to upload document '{0}'
10_014 Shareholder with code='{0}' does not exist
10_015 Required field '{0}' is not specified
10_016 The country code '{0}' is not supported
10_017 No content supplied for document '{0}'
10_018 File '{0}' can possibly contain malware or a virus. Not accepted
10_019 Failed to delete bank accounts for account holder '{0}'
10_020 Failed to delete shareholders for account holder '{0}'
10_021 Failed to retrieve documents for account '{0}'
10_022 Failed to get account details for account '{0}'
10_023 Failed to get legal entity type for account '{0}'
10_024 Invalid accountstatus '{0}'
10_025 Invalid Notification Service Version '{0}'
10_026 Invalid Notification URL '{0}'
10_027 Not able to determine accountHolder balance
10_028 Amount not specified
10_029 Invalid amount '{0}'
10_030 Events cannot be included and excluded from the notification in the same time. Invalid events: {0}
10_031 Notification configuration cannot be saved. Details:
10_032 There is no notification configuration with id {0}, defined for marketplace {1}
10_033 Notification configuration {0} cannot be retrieved
10_034 Notification configurations {0} cannot be deleted
10_035 Failed to retrieve account holder '{0}'
10_036 Details of account {0} cannot be saved
10_037 The minimum accepted file size : {0} bytes. The size of the file '{1}' is {2} bytes
10_039 File '{0}' is of invalid format. Accepted formats: pdf, jp(e)g and png
10_046 Bank account not found, accountHolder: '{0}', bankAccountUUID: '{1}'
10_047 Failed to retrieve account holder review information
10_048 There is no review information with review id '{0}'
10_049 Failed to update account holder review information for review id '{0}'
10_050 There is no review comment specified for review id '{0}'
10_051 Cannot update review with review id '{0}'. The status '{1}' is not a final status
10_052 Cannot update review with review id '{0}', since it is already in the final status
10_053 Notification configuration {0} cannot be saved, since its description is missing
10_054 Notification configuration {0} cannot be saved, since description '{1}' has already be reserved for another configuration. Please provide another description.
10_055 Marketplace with code='{0}' does not exist
10_056 Modification of KYC check review '{0}' is not allowed
10_057 KYC check review retrieval is not allowed
10_058 Payout limit reached for account '{0}', limit: '{1}'
10_059 Failed to suspend account: accountCode='{0}'
10_060 Failed to unSuspend account: accountCode='{0}'
10_061 Operation not allowed because of account status. accountCode: '{0}', status: '{1}'
10_062 Processing is not allowed because the account holder {0} is not in the processing state.
10_063 Payout is not allowed because the account holder {0} is not in the payout state.
10_064 Unable to retrieve KYC verification statuses for account holder {0}
10_066 There is not enough balance available for account {0}. Available balance: {1}; Requested amount: {2}
10_067 Not able to find bank account for {0} in currency {1} with bank account UUID {2}
10_068 Not able to find bank account for {0} in currency {1}
10_069 Payout has been failed for account {0}. Details: {1}.
10_070 Filename is missing for the document being uploaded. Account holder code: {0}
10_071 When disabling account holder state, a reason must be specified
10_072 Failed to update state {0} for account holder {1}
10_073 Unknown Tx Satus: {0}
10_074 The bankAccountUUID is missing, this is required for bank statement upload
10_075 Processing limit reached for account '{0}', limit: '{1}'
10_076 No transferCodes configured for Marketplace
10_077 Provided transfer code can't be used
10_078 Fund transfer failed for account {0}
10_079 Source and destination must be different accounts
10_080 No account holder or account specified
10_081 Both bank account and shareholder specified
10_082 KYC Check {0} not defined for owner {1}
10_083 KYC check {0} is already in state {1}
10_084 Schedule '{0}' is unknown
10_085 Beneficiary flow not allowed for marketPlace
10_086 Account {0} already has a beneficiary setup
10_087 Account {0} has already been paid out
10_088 The maximum accepted file size : {0} bytes. The size of the file '{1}' is {2} bytes
10_089 Not allowed to transfer a negative amount. Amount: {0}
10_090 Bank account with uuid {0} of account {1} already exists.
10_091 The liable account holder, {0}, can not be modified, please contact Adyen Support for modifications.
10_092 When disabling account schedule, a reason must be specified
10_093 Existing beneficiary transfer in progress for account, please try again later.
10_094 Either shareholder code or bank account UUID, but not both of them, can be provided in order to retrieve account holder documents
10_095 The beneficiary account holder {0} has not completed onboarding requirements for a tier equal to or higher than the benefactor account holder {1}
10_096 Increasing the tier for account holder {0} is not possible
10_097 Provided {0} tier {1} is invalid
10_098 Neither data provided for account holder update request
10_100 The document '{0}' has already been uploaded
10_102 The provided legal entity type {0} is not valid
10_103 The provided primary currency {0} is not valid
10_104 Shareholder codes {0} cannot be deleted, as business account {1} must have at least one shareholder.
10_105 The shareholderCode is missing. This is required for a photo ID upload for shareholders
10_106 The image uploaded is too small. The minimum accepted image file size : {0} bytes. The size of the file '{1}' is {2} bytes
10_107 When manually disabling payouts internal and external reasons must be provided
10_108 Provided document {0} is deemed invalid, it could not be read
10_109 The document {0} exceeds the maximum allowed number of pages {1}
10_110 Invalid accountCode: accountCode='{0}'; reason='{1}'
10_111 Payout schedule cannot be modified, it is blocked at marketplace
10_112 There is not enough balance available in the marketplace virtual account to perform an express payout. Available balance: {0}; Requested amount: {1}
10_113 Validation error occurred, see invalidFields property
10_114 The provided Hmac key is invalid. A 32 bytes key is required
10_115 Failed to close account: accountCode='{0}'. Non-zero balance remaining.
10_116 Failed to close accountHolder: accountHolderCode='{0}'. Non-zero balance remaining.
10_117 Failed to close accountHolder: accountHolderCode='{0}'
10_118 Not able to find payout method for {0} with payout method code {1}
10_119 Bank account and payout method cannot both be present in the request
10_120 idNumber field and documentData field not allowed in the same time on personalData object with different value
10_121 The provided document type {0} is not supported.
10_122 Bank statement is not allowed for shareholders.
10_123 ID document is not allowed for bank accounts.
10_124 The marketplace is not allowed to use the HOP service
10_125 There is no valid stores configuration found on the marketplace account
10_126 There is no return url configured to use the HOP service
10_127 Store not found, accountHolder: '{0}', storeCode: '{1}'
10_128 Invalid operation for current store status, accountHolder: '{0}', storeCode: '{1}', status: '{2}'
10_129 Store does not belong to account '{0}', storeCode: '{1}'
10_130 Failed to initiate the automated direct debit.
10_131 HOP cannot be used on SUSPENDED or CLOSED accounts.
10_132 Payout has been failed for account {0}. Details: {1}.
10_133 Payout has been failed for account {0}. Details: {1}.
10_134 Payout has been failed for account {0}. Details: {1}.
10_135 Payout has been failed for account {0}. Details: {1}.
10_136 The maximum number of chained beneficiaries has been reached
10_137 Failed to retrieve account holder by legal entity reference '{0}'

Account holder error codes

These error codes may be returned when you manage account holders by making /createAccountHolder and /updateAccountHolder calls.

Error code Message
1 Field is missing
2 Email address is invalid
3 Country code is invalid
4 Value contains illegal characters (numbers)
5 URL is invalid
6 Date is not in a format yyyy-MM-dd
7 Date is not in a valid range (1900 - now)
8 Bank details are invalid
9 Postal code is invalid for the country
10 State code is invalid, should be 1-3 characters
11 State code is unknown for the country
12 AccountHolderDetails.fullPhoneNumber and AccountHolderDetails.phoneNumber provided, please provide one or another
13 fullPhoneNumber is not a valid phone number
14 phoneNumber is too short
15 Country is not supported
16 Unknown currency
17 IBAN and accountNumber/branchCode/bankCode are specified, please provide one or another.
18 Can not determine bank code from branch code {0} and account number {1}, please supply bank code.
19 Provided tier number {0} is not valid, value needs to equal or higher then 0 and lower or equal than the maximum available tier.
20 Field should not be filled for country {0}.
21 Account description '{0}' is not valid.
22 This currency and/or country is not supported for payouts.
23 Account holder code does not exists or invalid.
24 Business details field not allowed on individual account.
25 Individual details field not allowed on business or non-profit account.
26 No tier configuration found for account.
27 Account update not allowed.
28 Account holder already exists with the accountHolderCode: {0}.
29 Account code does not exist or invalid.
30 Field should not be filled.
31 Account holder does not exists with the accountHolderCode: {0}.
32 Account holder update not allowed.
33 Account has an invalid status for requested operation, current status: {0}.
34 An invalid {0} code is provided for value '{1}'"), // e.g. An invalid bankAccount code is provided.
40 No document content was provided.
41 The maximum accepted file size : {0} bytes. The size of the file '{1}' is {2} bytes.
42 The image uploaded is too small. The minimum accepted image file size : {0} bytes. The size of the file '{1}' is {2} bytes.
43 File '{0}' can possibly contain malware or a virus. Not accepted.
44 The document '{0}' has already been uploaded.
45 File '{0}' is of invalid format. Accepted formats: pdf, jp(e)g and png.
46 The document {0} exceeds the maximum allowed number of pages {1}.
50 Bank account does not exist for bankAccountCode: {0}.
51 Currency code is invalid. code: {0}.
52 Amount is negative or zero. value: {0}.
53 Source and destination must be different accounts.
54 Not enough balance.
55 Account holder has an invalid status for requested operation, current status: {0}.
56 Account holder {0} has beneficiary setup. Fund transfer is not allowed.
57 Fund transfer/payout is not allowed for account: {0}
58 Outgoing transfer/payout limit reached for account '{0}', limit: '{1}'
70 Shareholder does not exist for shareHolderCode: {0}.
71 Shareholder codes {0} cannot be deleted, as business account {1} must have at least one shareholder.
72 Payout instrument token does not exist for payoutInstrumentTokenCode: {0}
73 Bank account and payout instrument token cannot both be present in the request.
74 P.O. Boxes are not allowed.
75 Bank statement is not allowed for shareholders.
76 ID document is not allowed for bank accounts.
77 Value {0} contains invalid characters.
78 No phone number or email found in the request. Please provide at least one.
79 Invalid POS stores configuration for marketplace. Reason: {0}.
80 The provided {0} tier may not be lower than or equal to the account holder's current Processing tier.
81 The provided {0} tier may not be lower than or equal to the account holder's current Payout tier.
82 Store does not exist for account '{0}', store: '{1}'.
83 Invalid operation for current store status. store: '{0}', with status: '{1}'.
84 Payout method with {0}: '{1}' not verified.
85 No verified payout method could be found for accountHolderCode: '{0}'.
86 Stores cannot be created in countries different from the account holder's address country.
87 Invalid bankAccountDetails in combination with resulting field value. Reason: {0}.
88 There is no user configured to use the HOP service.
89 There is no return URL found for the request.
90 The max no. of allowed chars in the URL are: {0}.
91 The return URL specified is invalid.
92 The fullPhoneNumber must be in the format of a beginning plus (+) followed by the country code and phone number. Only digits and the leading plus are permitted.
93 Error with the countryCode
94 Error with the accountNumber
95 Error in the bankAccountName
96 Error with the bankCode
97 Error with the branchCode
98 Error with the checkCode
99 Error with the iban
100 Error with the bankBicSwift
101 Error with the ownerName
102 Error with the bankCity
103 Error with the ownerCity
104 Error with the ownerStreet
105 Error with the stateOrProvince
106 Error with the ownerPostalCode
107 Error with the ownerCountryCode
108 Error with the accountType
109 Error with the taxId
110 Bank account already registered for this account holder with bank account UUID.
111 Bank account not found for current currency and UID.
112 Bank account country cannot be different from address country except for EU.

See also