Error Codes

Successful requests will return a HTTP 200 response and may or may not include a response body, depending on the request endpoint.

Whenever a problem occurs, Alfred will respond to the client using a 4xx or 5xx status code. All
4xx status codes indicate a problem with your request, while a 5xx status code indicates an internal problem with our systems.

All exceptions come equipped with an error code ID. If you require support, please supply this identifier to assist our support team in locating your issue.

The following table describes the fields included in the returned JSON exception:

Field	Description
errorCode	A unique identifier for this exception. This is very helpful when contacting support
errorMessage	A human-friendly description of the problem
errorMetadata	Describes the associated fields related to the error

An example JSON representation:

{
	"errorCode": 110002,
	"errorMessage": "Invalid field(s)"
	"errorMetadata: {
		"fields": ["fromCurrency", "toCurrency"]
	}
}

Error Codes

Error Code	Error Message
110002	Invalid field(s)
110003	Bank Unresponsive
111301	UNKNOWN_ERROR
111302	Invalid parameter(s)
111303	Required parameter(s) missing
111304	Customer IP not allowed
111305	Unauthorized
111306	Unsupported trading pair
111307	Unsupported fiat method
111308	Unsupported chain
111309	Given fiat account does not belong to the customer
111310	Customer has exceeded their deposit limit
111311	Deposit exceeds single deposit limit
111401	EDD verification form must be completed to continue
111402	KYC submission not found
111403	KYB submission not found
111404	KYC record cannot be retried
111405	KYB record cannot be retried
111406	Customer KYC incomplete
111407	Customer KYB incomplete
111408	Phone number already registered
111409	Email already registered
111410	Phone country code and customer country does not match
111411	KYC has already been completed for this customer
111412	KYB has already been completed for this customer
111413	Invalid ID type
111414	Invalid file submission
111415	Customer not found
111416	Business customer not found
111417	Invalid customer
111426	Outside the trade limit for fromCurrency and toCurrency
111427	Invalid amount
111428	Quote not found
111429	Quote already used or expired
111430	Invalid quote for onramp
111431	Invalid quote
111432	Quote does not correspond to a fiat currency
111433	From Currency is not the same as from currency of quote
111434	To Currency is not the same as to currency of quote
111435	Amount is not the same as from amount of quote
111436	Chain is not the same as chain of quote
111437	Payment method type is not the same as payment method type of quote
111438	Please, only send one field, can be fromAmount or toAmount
111451	Fiat method and currency is unsupported
111476	Onramp deposit not found
111477	Onramp trade not found
111478	Onramp transaction not found
111479	Duplicate onramp deposit found
111480	Duplicate onramp trade found
111481	Duplicate onramp transaction found
111482	Fiat account not found
111483	Offramp not found
111484	Account number not valid
111485	Fiat account for already exists
111526	Invalid support ticket type
111527	Duplicate support request found
111551	Unexpected kyc status
111552	Unexpected kyb status
111553	Unexpected onramp transaction status
111554	Unexpected offramp transaction status
111555	Reference id not found
111556	Invalid event type
111557	Expected metadata not found
111558	Customer is already registered with that email and country
111559	The specified customer or fiat account could not be found. Please verify the provided details and try again
111560	Invalid payment method
111561	fromCurrency Would be diferent toCurrency
111562	Invalid calculated fromAmount
111563	No deposit address found
111564	Payment not found:
111565	The encrypted data has expired.
111566	Error decrypting data: invalid data

KYC Warning Codes

Please note: alfred may configure a different decision upon request, with the approval of compliance.

Warning Code	Description	Decision
UNRECOGNIZED_DOCUMENT	Document not recognized.	REVIEW
UNREADABLE_DOCUMENT	Document not readable.	REVIEW
DOCUMENT_NOT_FOUND	Document is not found in the uploaded image.	DECLINED
DOCUMENT_EXPIRED	Document is expired.	DECLINED
DOCUMENT_FRONT_BACK_MISMATCH	Document front and back does not belong to same person.	REVIEW
DOCUMENT_DAMAGED	The document is damaged.	REVIEW
DOCUMENT_FRONT_MISSING	Document front not detected in the document image.	DECLINED
DOCUMENT_BACK_MISSING	Document back not detected in the document image.	DECLINED
DOCUMENT_FRONT_OR_BACK_MISSING	Document front or back is missing or cannot be read.	DECLINED
DOCUMENT_CROPPED	Document not fully in frame / cropped.	REVIEW
DOCUMENT_FACE_NOT_FOUND	Could not detect face in document image.	REVIEW
DOCUMENT_TOO_FAR	The document is too far from the camera.	APPROVED
DOCUMENT_TAMPERED	Document patterns hint at tampering or recreation.	REVIEW
AGE_UNDER_18	User is under 18 years old.	REVIEW
INVALID_DOCUMENT_DETAILS	Document data is invalid or not as per the standards.	REVIEW
ID_PREVIOUSLY_SEEN	The given identity document/number has been previously verified.	APPROVED
DATABASE_LOOKUP_ISSUE	The data could not be verified with a third-party/government database.	REVIEW
MRZ_DATA_MISMATCH	Data from MRZ / Barcode / QR code does not match with the extracted data.	APPROVED
MISSING_EXPIRY_DATE	Document expiry date is missing or cannot be read.	REVIEW
MISSING_ISSUE_DATE	Document issue date is missing or cannot be read.	REVIEW
MISSING_BIRTH_DATE	Birthday information is missing or cannot be read.	APPROVED
MISSING_DOCUMENT_NUMBER	Document number is missing or cannot be read.	REVIEW
MISSING_PERSONAL_NUMBER	Personal number or national ID number is missing or cannot be read.	APPROVED
MISSING_ADDRESS	Address is missing or cannot be read.	APPROVED
MISSING_POSTCODE	Postcode is missing or cannot be read.	APPROVED
MISSING_NAME	Given name or family name is missing or cannot be read.	REVIEW
MISSING_GENDER	Gender is missing or cannot be read.	APPROVED
MISSING_NATIONALITY	Nationality is missing or cannot be read.	APPROVED
MISSING_DOCUMENT_DETAILS	Document data is missing or cannot be read.	APPROVED
NAME_VERIFICATION_FAILED	Mismatch between supplied user name and extracted/looked up name.	APPROVED
BIRTH_DATE_MISMATCH	Mismatch between supplied birthday and extracted/looked up birthday.	APPROVED
ID_DATA_MISMATCH	Mismatch between supplied user data and data from third-party database.	APPROVED
ID_TYPE_MISMATCH	The ID type does not match with the input identity type.	APPROVED
ID_COUNTRY_MISMATCH	The ID issue country does not match with the input country.	DECLINED
ADDRESS_MISMATCH	Mismatch between supplied address and extracted/looked up address.	APPROVED
ID_NOT_ALLOWED	Identity type is not enabled in the template.	APPROVED
EMAIL_ADDRESS_MISMATCH	Mismatch between supplied email address and extracted/looked up email.	APPROVED
PHONE_NUMBER_MISMATCH	Mismatch between supplied phone number and extracted/looked up number.	APPROVED
DOCUMENT_PHOTO_OF_PHOTO	Document appears to be a photo of a photo.	REVIEW
SCREEN_DETECTED	The document image contains a screen or monitor.	REVIEW
IMAGE_FORGED_EDITED	The document image possibly contains forged elements.	REVIEW
FEATURE_VERIFICATION_FAILED	Document features do not match with official document.	REVIEW
FAKE_ID	The document uploaded is a fake or sample document.	REVIEW
DOCUMENT_FOUND_ON_INTERNET	The document image is found on the internet.	REVIEW
ARTIFICIAL_IMAGE	Document appears to be artificially created.	REVIEW
ARTIFICIAL_TEXT	Most texts within the image appear to be created artificially.	REVIEW
TEXT_FORGERY	Possible artificial text modification detected.	REVIEW
IMAGE_TOO_SMALL	The image resolution did not meet the standards.	REVIEW
GLARE_DETECTED	The document image contains possible glare.	REVIEW
IMAGE_TOO_BLURRY	The document image is blurry.	REVIEW
CHECK_DIGIT_FAILED	Document contains invalid check digit.	REVIEW
PRINTOUT_DETECTED	The document image is a print out or photocopy.	REVIEW
BLACK_WHITE_DOCUMENT	Document appears to be a black & white photocopy.	REVIEW
FACE_NOT_FOUND	Could not detect face in selfie image.	DECLINED
MULTIPLE_FACES	Multiple faces detected in selfie image.	DECLINED
FACE_MISMATCH	Face mismatch between document/government photo and selfie.	DECLINED
LOW_FACE_SIMILARITY	Low similarity between document and selfie face.	REVIEW
FACE_IDENTICAL	Selfie appears to be the exact same photo as document photo.	REVIEW
FACE_NOT_LIVE	Selfie photo is not live.	DECLINED
FACE_PHOTO_OF_PHOTO	Selfie photo appears to be a photo of a photo.	DECLINED
FACE_COVERED	Face in selfie is covered with hat/mask/glasses.	DECLINED
FACE_EDITED	Selfie photo edited using filters.	DECLINED
FACE_BLUR	Selfie photo is too blurry.	DECLINED
FACE_TOO_CLOSE	Selfie photo is too close to camera.	DECLINED
FACE_CROPPED	Selfie photo is cropped or not fully visible.	DECLINED
FACE_TOO_SMALL	Face size in selfie is too small.	DECLINED
FACE_ANGLE_TOO_LARGE	Facial rotation angle too large.	DECLINED
FACE_LIVENESS_REVIEW_REQUIRED	Manual review required for selfie liveness.	REVIEW
FACE_DEEPFAKE	Selfie photo appears to be a deepfake.	REVIEW
SELFIE_VIDEO_FRAUD	Selfie video appears to be fraudulent.	DECLINED
FACE_AGE_MISMATCH	Supplied age doesn't match facial age estimate.	APPROVED
FACE_LIVENESS_TOO_FAR_FROM_CAMERA	Face is too far in selfie.	REVIEW
ID_NUMBER_NOT_VERIFIED	ID number could not be verified.	DECLINED
INVALID_ID_NUMBER_SUPPLIED	ID number format is invalid.	DECLINED
LOOKUP_SOURCE_DOWN	Government/third-party source is unavailable.	DECLINED
LOOKUP_FACE_NOT_FOUND	No face image found in database.	DECLINED
AML_MATCH	Potential match from AML database.	REVIEW
GEOLOCATION_MISMATCH	Geolocation does not match ID country.	REVIEW
SUSPICIOUS_USER_BEHAVIOUR	Detected suspicious behavior.	REVIEW
IP_ADDRESS_SUSPICIOUS	Request from suspicious IP.	REVIEW
TOR_DETECTED	User is using TOR.	APPROVED
VPN_DETECTED	User is using VPN.	APPROVED
BOT_DETECTED	BOTs detected during request.	APPROVED
BROWSER_PREVIOUSLY_ATTEMPTED	Same browser used for multiple attempts.	APPROVED
IP_ADDRESS_PREVIOUSLY_ATTEMPTED	Same IP used for multiple attempts.	APPROVED
ID_PREVIOUSLY_ATTEMPTED	Multiple attempts using same ID.	APPROVED
FACE_PREVIOUSLY_ONBOARDED	Face image has onboarded before.	APPROVED
PRIVACY_SETTINGS_BLOCKED	User’s privacy settings blocked location data.	APPROVED
ADDRESS_DOCUMENT_MISSING_ADDRESS	Address missing or unreadable in address document.	REVIEW
ADDRESS_DOCUMENT_ADDRESS_MISMATCH	Supplied and extracted address mismatch.	REVIEW
ADDRESS_DOCUMENT_MISSING_NAME	Name missing in address document.	REVIEW
ADDRESS_DOCUMENT_NAME_VERIFICATION_FAILED	Supplied and extracted name mismatch.	REVIEW
ADDRESS_DOCUMENT_MISSING_ISSUE_DATE	Issue date missing in address document.	REVIEW
ADDRESS_DOCUMENT_DOCUMENT_EXPIRED	Address document expired.	REVIEW
ADDRESS_DOCUMENT_UNRECOGNIZED_DOCUMENT	Address document not recognized.	DECLINED
UNABLE_TO_EXTRACT_DOCUMENT_METADATA	Could not extract metadata from document.	REVIEW
ADDRESS_DOCUMENT_DOCUMENT_NOT_ISSUED_RECENTLY	Document not issued within last 3 months.	REVIEW
EMAIL_NOT_FOUND	No email address found.	DECLINED
PHONE_NUMBER_NOT_FOUND	No phone number found.	DECLINED
BACKGROUND_CHECK_ALERT	Background check found records.	REVIEW
CUSTOM_ERROR_CODE	Custom error with specific explanation.	REVIEW
API_DATA_REQUIREMENTS_NOT_MET	Required API fields are missing.	UNKNOWN