Error codes

Learn about MarketPay error codes and what they mean.


This page contains codes and descriptions of all errors that may occur when you communicate with the Adyen MarketPay 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 the Adyen MarketPay system.

Error Code Description

10_001

Internal timeout.

10_002

Internal error: message='{0}'

10_003

Failed to authorize the 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 account code.

10_009

Invalid email address.

10_010

Account with account code has already been closed.

10_011

Failed to close the account with the provided account code.

10_012

Invalid account type.

10_013

Failed to upload the document.

10_014

Shareholder with provided share holder code does not exist.

10_015

Required fields are not provided.

10_016

The country code is not supported.

10_017

No content supplied for document.

10_018

Uploaded document may possibly contain malware or a virus. Not accepted.

10_019

Failed to delete bank accounts for the account holder.

10_020

Failed to delete share holders for the account holder.

10_021

Failed to retrieve documents for the account.

10_022

Failed to get account details for the account.

10_023

Failed to get legal entity type for the account.

10_024

Invalid account status.

10_025

Invalid notification service version.

10_026

Invalid Notification URL.

10_027

Not able to determine account holder balance.

10_028

Amount not specified.

10_029

Invalid amount.

10_030

Events cannot be included and excluded from the notification at the same time.

10_031

Notification configuration cannot be saved.

10_032

There is no notification configuration with the provided ID. Defined for marketplace.

10_033

Notification configuration could not be retrieved.

10_034

Notification configurations cannot be deleted.

10_035

Failed to retrieve account holder.

10_036

Details of account cannot be saved.

10_037

The minimum accepted file size bytes.

10_039

Uploaded file is in an invalid format.

10_040

Failed to retrieve account state configuration for account holder.

10_041

Failed to update account state configuration for account holder.

10_042

Failed to delete account state configuration for account holder.

10_044

Limit amount for the account holder and the state cannot exceed the maximum allowed limit amount.

10_045

Limit amount for the account holder and state is accepted only in specified currency.

10_046

Bank account not found.

10_047

Failed to retrieve account holder review information.

10_048

There is no review information with review id.

10_049

Failed to update account holder review information for review id.

10_050

No review comment specified for review id.

10_051

Cannot update review with review id.

10_052

Cannot update the review with review id as it is already in the final status.

10_053

Notification configuration cannot be saved as its description is missing.

10_054

Notification configuration cannot be saved as the description has already be reserved for another configuration.

10_055

Marketplace with code does not exist.

10_056

Modification of KYC check review is not allowed.

10_057

KYC check review retrieval is not allowed.

10_058

Payout limit reached the account limit.

10_059

Failed to suspend the account.

10_060

Failed to unsuspend the account.

10_061

Operation is not allowed because of account status.

10_062

Processing is not allowed because the account does not have the processing account state.

10_063

Payout is not allowed because the account does not have the payout state.

10_064

Unable to retrieve KYC verification statuses for the account holder.

10_065

There is no balance for the account.

10_066 There is not enough balance available for account {0}. Available balance: {1}; Payout 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_080 No account holder or account specified
10_091 The liable account holder, {0}, can not be modified, please contact Adyen Support for modifications.
10_095 The destination account holder, {0}, is not in a higher tier.
10_097 Provided processing tier {0} is invalid.
10_100 The document '{0}' has already been uploaded.
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 : 100000 bytes. The size of the file '{0}' is {1} bytes
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}'

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.
74 P.O. Boxes are not allowed.

See also