Onboarding Error Codes

You can use the errorDetails object in all of the APIs related to Onboarding. In this object, code can be used to classify messages and to handle different error codes.

Example:

• You can direct an applicant to the business details page when receiving error E100 or F100.
• You can change the error message and appropriately guide your customer when receiving error R601.

The error codes on this page are composed of a letter and a 3-digit number.

Cxxx – RFI

Error code	Error source
C101	Reference ID is required to process the responded RFI for Template 0. (only for clients who have not integrated RFI HashId)
C102	Either rfiHashId or rfiTemplateId is required for one of the RFIs
C301	Reference ID is incorrect for the responded RFI for Template 0.
C302	Invalid RFI template ID(s) 0.
C303	No matching template found for uniqueId with the given rfiHashId
C304	No matching template found for the given rfiHashId
C305	rfiHashId is required to resolve multiple open templates with the same templateId e47fbae2-aee2-43d4-9524-c8fcf6513616
C306	Invalid UniqueId
C401	Provided Information or document is incorrect for the responded RFI for Template 0.
C402	The RFI has already been responded for template ID 0.

Exxx – Missing field in request

Error code	Error source
E100	Business information
E200	Stakeholder details
E300	Applicant details
E400	Risk assessment info info, Nature Of Business
E500	Additional info Expected Account Usage
E600	RFI
E800	Region
E900	Bank details (HK)

Fxxx – Invalid field in request

Error code	Error source
F100	Business information
F200	Stakeholder details
F300	Applicant details
F400	Risk assessment info info, Nature Of Business
F500	Additional info Expected Account Usage
F600	RFI
F800	Region
F900	Bank details (HK)

Ixxx – Errors from partners

Error code	Error source
I000	KYC is approved.
I100	Fetching data from the partner is not complete.
I300	The application is being reviewed by our compliance agent.
I400	Validation error at one of our partners
I500	An internal service is down.
I601	The status change request is from an invalid status.
I602	The status change request is from an unauthorized personnel.
I603	The link expired.

Pxxx and Qxxx – Parameters are invalid

Error code	Error source
P100	Parameters are missing.
	–– Q ––
Q100	Parameters are invalid.
Q101	Combination of parameters could not be used to find data.
Q102	clientHashId cannot be found.
Q103	customerHashId cannot be found.

Rxxx and Zxxx – Other errors

Error code	Error source
R400	Bad request – anything that can't be categorized above.
R401	KYC was already completed.
R403	The document was already uploaded.
R408	The link already expired.
R500	Any internal service, vendor, or underlying service is down.
R601	Status change request from an invalid status.
R602	Link regeneration failed - while customer applicant KYC is submitted.
R603	Link regeneration failed - while customer applicant KYC is in ERROR state.
R604	Link regeneration failed - link regeneration can't be initiated for this compliance status.
R605	Link regeneration failed - link regeneration can't be initiated for the applicant's current KYC status.
R606	That functionality isn't available in the current status.
R607	The customer can't be created in the current status.
R608	The customer can't use functionalities like the Get Application Details API until after the applicant's KYC is submitted.
R609	An invalid request structure was provided in the stakeholders object.
R700	Too many requests.
R800	Resubmission is blocked because the application was rejected due to high risk.
Z100	Any error that isn't classified in the above scenarios.

caution

In some cases, the errorDetails field may not be available where the previous version of errors field is in use.