Account management API error codes

Legend
DEPRECATED
Deprecated
(warning) Warning
(error) Error

The account management API may run into a problem during data manipulation operations.

The table below gives an overview of the warning and error codes, and the corresponding messages, that are returned when the API meets with unexpected behaviour.

Error code Error message Placeholders Notes
6_001 {0} is not possible for contactType {1}, ignoring.
  • 0fieldName
  • 1: contactType

(warning)

DEPRECATED

6_002

{0} is required for contactType {1}.

  • 0fieldName
  • 1: contactType
(error)
6_003

Failed to process the field {0} as a phoneNumber for contactType {1}.

  • 0fieldName
  • 1: contactType
(error)
8_001

Failed to determine the executing user, contact the Support Team.

  (error)
8_002

Failed to determine the owner company of the user '{0}', contact the Support Team.

  • 0: userName
(error)
8_003

The executing user lacks the necessary permissions, contact the Support Team.

  (error)
8_004 Only fill in merchantCode, as accountKey is deprecated.   (warning)
8_005 MerchantCode is a required field (accountKey is deprecated).   (error)
8_006 AccountKey is deprecated, use merchantCode instead.   (warning)
8_007 Lacks permission to account '{0}'
  • 0accountKey
(error)
8_008 Lacks permission to merchant '{0}'
  • 0: merchantCode
(error)
8_009 Incorrect accountKey '{0}', should be in the form of 'Company.companyCode' or 'MerchantAccount.merchantCode'
  • 0accountKey
(error)
8_010 Incorrect merchantCode '{0}'
  • 0: merchantCode
(error)
8_011

Could not retrieve account '{0}', contact the Support Team.

  • 0accountKey
(error)
8_012

Could not retrieve merchant '{0}', contact the Support Team.

  • 0: merchantCode
(error)
8_013 Failed to retrieve the supported payoutSchedules for merchant '{0}'
  • 0: merchantCode
(error)
8_014 Not providing payoutScheduleDays, the payoutSchedule value '{0}' is not supported by the update call
  • 0: payoutSchedule
(warning)
8_015 startYear is not specified   (error)
8_016 startYear should be the current year or the next   (error)
8_017 startMonth is not specified   (error)
8_018 startMonth should be at least next month   (error)
8_019 costContractName is not specified   (error)
8_020 costContractName '{0}' is invalid
  • 0: costContractName
(error)
8_021 Failed '{0}': minimumTxs, minimumAmount, remark, billable must not be set for MerchantAccounts
  • 0accountKey
(error)
8_022

Failed '{0}': no allowed costContract defined, contact the Support Team.

  • 0accountKey
(error)
8_023

Failed '{0}': costContract '{1}' not allowed, contact the Support Team.

  • 0accountKey
(error)
8_024

Failed '{0}': failed to retrieve the costContracts, contact the Support Team.

  • 0accountKey
(error)
8_025 Failed '{0}': currently set startDate '{1}' must be after latest startDate '{2}'
  • 0accountKey
  • 1: current startDate
  • 2: latest startDate
(error)
8_026 Failed '{0}': contract periods have gap or overlap
  • 0accountKey
(error)
8_027 Failed '{0}': contract startDate must be before endDate
  • 0accountKey
(error)
8_028 Failed '{0}': contract stopDate must be in future
  • 0accountKey
(error)
8_029

Failed '{0}': could not update costContract, contact the Support Team.

  • 0accountKey
(error)
8_030

Failed '{0}': could not add costContract, contact the Support Team.

  • 0accountKey
(error)
8_031 Failed addMerchantCodes '{0}': problem with merchant
  • 0: merchantCode
(error)
8_032 Failed addMerchantCodes '{0}': already added
  • 0: merchantCode
(error)
8_033

Failed addMerchantCodes '{0}': unknown error, contact the Support Team.

  • 0: merchantCode
(error)
8_034 Failed deleteMerchantCodes '{0}': problem with merchant
  • 0: merchantCode
(error)
8_035 Failed deleteMerchantCodes '{0}': not even added
  • 0: merchantCode
(warning)
8_036

Failed deleteMerchantCodes '{0}': unknown error, contact the Support Team.

  • 0: merchantCode
(error)
8_037

Failed grantRoles '{0}': incorrect role, contact the Support Team.

  • 0: roleName
(error)
8_038 Failed grantRoles '{0}': already granted
  • 0: roleName
(warning)
8_039

Failed grantRoles '{0}': unknown error, contact the Support Team.

  • 0: roleName
(error)
8_040

Failed revokeRoles '{0}': incorrect role, contact the Support Team.

  • 0: roleName
(error)
8_041 Failed revokeRoles '{0}': not even granted
  • 0: roleName
(warning)
8_042

Failed revokeRoles '{0}': unknown error, contact the Support Team.

  • 0: roleName
(error)
8_043 No merchants assigned, disabling user   (warning)
8_044 No merchants assigned, can't activate user   (error)
8_045 The user '{0}' is not editable
  • 0userName (ex.: the "admin" user)
(error)
8_046 Failed to send verification e-mail to '{0}'
  • 0: email address
(warning)
8_047

Failed to update contact details: unknown error when updating the contact details, contact the Support Team.

  (error)
8_048

Failed name and/or email: unknown error when adding the contact details, contact the Support Team.

  (error)
8_049

Failed timeZoneCode: unknown error when updating, contact the Support Team.

  (error)
8_050

Failed active: unknown error when adding the contact details, contact the Support Team.

  (error)
8_051 Role(s) in both grant and revoke: {0}
  • 0: comma-separated list of roles
(error)
8_052 Merchant(s) in both add and delete: {0}
  • 0: comma-separated list of merchantCodes
(error)
8_053 Password generation failed   (error)
8_054

Unknown error when creating user, contact the Support Team.

  (error)
8_055 name is not specified   (error)
8_056 userName is not specified   (error)
8_057 email is not specified   (error)
8_058 timeZoneCode is not specified   (error)
8_059 name.firstName is not specified   (error)
8_060 name.firstName '{0}' is invalid: exceeds the length {1}
  • 0: firstName
  • 1: max. allowed length (chars)
(error)
8_061 name.infix '{0}' is invalid: exceeds the length {1}
  • 0: firstName
  • 1: max. allowed length (chars)
(error)
8_062 name.lastName is not specified   (error)
8_063 name.lastName '{0}' is invalid: exceeds the length {1}
  • 0: firstName
  • 1: max. allowed length (chars)
(error)
8_064 name.gender is not specified   (error)
8_065 userName '{0}' is invalid: allowed characters are {0}
  • 0: userName
  • 1: max. allowed length in regex format
(error)
8_066 email '{0}' is invalid
  • 0: email address
(error)
8_067 timeZoneCode '{0}' is invalid
  • 0: time zone
(error)
8_068 userName '{0}' is already in use
  • 0: userName
(error)
8_069 no change allowed: status is '{0}', pending for '{1}'
  • 0: current status
  • 1: pending status
(error)
8_070 no change made: status is already '{0}'
  • 0: current status
(warning)
8_071 no change allowed: status is '{0}'
  • 0: current status
(error)
8_072 no change allowed: status is '{0}', requested by an internal user
  • 0: current status (Blocked only)
(error)
8_073 no change allowed: status '{0}' is not allowed to be set via an API call
  • 0: status (NotPayable only)
(error)
8_074 no costContracts found   (error)
8_075 the latest costContract's startDate '{0}' must be at least '{1}' for removal
  • 0: startDate
  • 1: date
(error)
8_076

Failed to delete costContract with startDate '{0}', contact the Support Team.

  • 0: startDate
(error)
8_077 userName '{0}' does not exist
  • 0: userName
(error)
8_078 userName '{0}' is not a WebUser
  • 0: userName
(error)
8_079

Failed to determine the type of userName '{0}', contact the Support Team.

  • 0: userName
(error)
8_080 currency is missing   (error)
8_081

BankAccount with currency '{0}' is marked for deletion, updating currently not possible, contact the Support Team.

  • 0: currency
(error)
8_082

BankAccount with currency '{0}' is marked for an update, updating currently not possible, contact the Support Team.

  • 0: currency
(error)
8_083 BankAccount with currency '{0}' does not exist, can't be updated
  • 0: currency
(error)
8_084 no changes for BankAccount with currency '{0}'
  • 0: currency
(warning)
8_085

Failed to update BankAccount with currency '{0}', contact the Support Team.

  • 0: currency
(error)
8_086 countryCode '{0}' is invalid
  • 0: countryCode
(error)
8_087 BankAccount with currency '{0}' is invalid: {1}
  • 0: countryCode
  • 1: error list
(error)
8_088 contactType '{0}' is not yet configured, can't update
  • 0: contactType
(error)
8_089

Failed to update contact with contactType '{0}', contact the Support Team.

  • 0: contactType
(error)
8_090 contactType is missing   (error)
8_091

Could not determine the contactType, contact the Support Team.

  (error)
8_092 contactType '{0}' is already configured, can't add
  • 0: contactType
(error)
8_093

Failed to add contact with contactType '{0}', contact the Support Team.

  • 0: contactType
(error)
8_094 contact.name did not change   (warning)
8_095 contact.personalData did not change   (warning)
8_096 contact.address did not change   (warning)
8_097 contact.email did not change   (warning)
8_098 contact.webAddress did not change   (warning)
8_099 contact.phoneNumber did not change   (warning)
8_100 {0} should not be empty
  • 0: fieldName
(error)
8_1002 {0} exceeds the length {1}
  • 0: fieldName
  • 1: max. allowed length
(error)
8_103 {0} did not change
  • 0: fieldName
(warning)
8_104

{0} is invalid: not a valid HTTP(S) url

  • 0: fieldName
(error)
8_105

{0} is invalid: not a valid 3-digits currency code

  • 0: invalid currency code
(error)
8_106

{0} '{1}' not allowed: the merchant does not have an approved bank account set up for this currency

  • 0: fieldName
  • 1: fieldValue
(error)
8_107

Failed to update {0}, contact the Support Team

  • 0: fieldName
(error)
8_108 payoutScheduleDays '{0}' specified is invalid, can be only one of {1}
  • 0payoutScheduleDays
  • 1: list of allowed values
(error)
8_109

Could not retrieve the supported payoutSchedules, contact Support Team.

  (error)
8_110

Could not retrieve the payoutSchedule for payoutScheduleDays '{0}', contact the Support Team.

  • 0payoutScheduleDays
(error)
8_111

Failed to update the payoutSchedule, contact the Support Team.

  (error)
8_112 No roles were granted, user set to inactive   (error)
8_112 No access was granted on merchants, user set to inactive   (error)