Errors

HTTP status conventions

Status	Meaning
400	Bad request.
401	Unauthorised - the access token or session has expired or is invalid.
403	Forbidden - the Authorization or Api-Key header is missing or invalid.
404	The requested resource was not found.
409	Conflict.
422	Validation error.
500	Server error.
502	Upstream error.

Error body shape

Errors are returned with the shape:

{
    "code": "...",
    "message": "..."
}

On some operations, the body also carries a transferErrorCode or a statusCode field.

Error codes

Code	HTTP status	Meaning
ConnectionNotFoundInSe	400	Connection Not Found In Salt Edge
CustomerIdIsNotAUuid	400	Customer is not a valid uuid
RequestValidationError	400	OpenAPI format error (for instance if a required parameter is missing or does not have the right format)
accountNotFound	404	The data sent is not valid
actionNeeded	400	An action is needed on the bank website
alreadyExists	409	See the operation's reference
alreadyRegistered	400	given customer already complete registration process
alreadyUsedCredentials	400	Credentials already used
already_sent	400	SMS has already been sent few minutes ago
amountRequired	400	Need to provide transaction amount parameter
askCodeBefore	400	No code asked before
badGetaway	502	See the operation's reference
bankAlreadyConnected	400	Customer already has a bank connection
bankConnectionAlreadySynchronized	400	Bank connection is not in error state, no need to resync because it could spoil active FT connection
bankConnectionNotFound	400	Bank connection not found
bankNotAvailable	400	Bank exists but is not available for connection
bankNotFound	400	Bank not found
captchaRequired	400	recaptcha code is required to ensure submission is not made by a bot
cardAlreadyLinked	400	Credit Card is already linked to the program
connectionAlreadyExists	400	The customer already have a connection with this bank
credentialsRequired	400	Credentials are required
creditCardAlreadyConnected	400	See the operation's reference
creditCardRequired	400	Credit Card is required
customerExternalIdRequired	400	customer external id (in programme repository)
customerIdMismatch	400	Customer id doesn't match
customerNotFound	400	Customer not found
duplicate	400	Same claim already made
emailAlreadyUsed	400	email is already taken
emailNotFound	400	Email not found
emailRequired	400	email is required
errorLinkingCard	400	Error while linking card to the program
eventDoesNotExist	400	Some events doeas not exist
eventNameNotFound	400	Event name was not found
expiredCode	400	Code is too old
expiredToken	401	The Authorization header has expired
externalIdAlreadyUsed	400	external id is already taken
incompleteRegistration	400	Customer must complete registration
insufficientAmount	400	Transaction amount is too low
internalServerError	500	See the operation's reference
invalidAmount	400	Transaction amount is invalid
invalidApiKeyHeader	400, 403	The Api-Key header is not valid
invalidAuthorizationHeader	403	The Authorization header is not valid
invalidBirthDate	400	birth date provided is invalid
invalidCaptcha	400	provided captcha is invalid
invalidChallengeId	400	Invalid challenge id parameter
invalidCode	400	Provided code is invalid
invalidConnectionId	400	Invalid connection id
invalidCountry	400	Country parameter is invalid. Need to be 2 letters ISO code. Multiple countries seperated with comma.
invalidCredentials	400	Provided credentials are invalid
invalidCustomer	400	Invalid customer identifier
invalidCustomerId	400	Customer id is not valid
invalidEmail	400	email is invalid
invalidExternalToken	400	Invalid external token
invalidFileType	400	Invalid file type
invalidIban	400	Invalid iban provided
invalidLanguage	400	invalid language code
invalidOptins	400	optins parameter is invalid
invalidParameter	400	ids is missing, not an array, empty, or contains a non-string/blank element
invalidPassword	400	Password format is invalid
invalidPeriod	400	Invalid startDate or endDate
invalidServiceId	400	serviceId parameter is invalid
invalidShoppingHubId	400	Programme identifier is invalid
invalidSponsorshipCode	400	No valid sponsorship code
invalidStoreId	400	No account found for this customer
invalidTokenFormat	400	Error while linking card to the program
invalidTransactionDate	400	Transaction date is invalid
invalidURL	400	Url is not valid
maxAttemptReached	400	Max attempt reached
missingApiKeyHeader	403	The Api-Key header was not found
missingAuthorizationHeader	403	The Authorization header was not found
noDefaultIban	400	See the operation's reference
noEndpointRegistered	400	There is no endpoint registered for this programme
noParameter	400	Need to provide either referralCode or phoneNumber + countryCode params
no_account	400	No account found for this customer
no_invalid_credentials	400	No credential update needed
notFullyRegistered	400	Customer not fully registered
nothingToPatch	400	No customer attributes to patch was provided
numberAlreadyUsed	400	phone number is already taken (legacy code, same as phoneAlreadyUsed)
phoneAlreadyUsed	400	See the operation's reference
phoneRequired	400	phone number is required (countryCode + phoneNumber)
providerError	400	Failed to create connection with the bank
resourceNotFound	404	See the operation's reference
storeExternalIdRequired	400	Store external ID is required
storeIdRequired	400	Need to provide store id parameter.
storeNotFound	400	Store not found
tooLargeFile	400	The provided file is too large
tooManyIds	400	ids contains more than 100 elements after dedupe
transactionAmountRequired	400	Transaction amount is required
transactionDateBeforeRegistration	400	Transaction date prior to registration date
transactionDateRequired	400	Transaction date is required
unauthorized	401	The route access is unauthorized
unknownPhone	400	Invalid phone number
unknown_phone	400	Unknown phone number
validationError	422	The data sent is not valid