User KYB process
Last updated
Was this helpful?
Last updated
Was this helpful?
nCore platform provides an automated feature to onboard SMEs (Small Medium Enterprises) under your business. With this feature you can create as many SMEs as you want under your business hub. As part of the SME onboarding process, the platform is required to automate the KYB (know your business) process through the APIs and the data is shown and validated by NymCard internally before making any decision to pass or fail the onboarding process.
Below you can find preliminary documents required for onboarding a corporate entity:
For the KYB process, there are following sub-user types which are required to create and upload their supporting documents for the KYB process.
The sub-users are given below:
Director
Signature
Shareholder
Shareholder_business
Once the users with such user types are created, then the system enables you to upload their identification documents.
After that you can create a main business user (i.e. the SME), and provide the sub-user’s (Director, Signature, and Shareholder) IDs in the request.
For example, you want to create a business user (SME) , whose name is “Test”. The SME Test has 3 Directors, 2 signatures and 5 shareholders. To create the use case, please follow the following steps:
Create all sub-users such as 3 Directors, 2 signatures and 5 shareholders one by one.
Then you should create identifications for each of 3 Directors, 2 signatures and 5 shareholders one by one.
After that you will be able to upload identification documents for each of 3 Directors, 2 signatures and 5 shareholders one by one.
And at last you will be able to create the business user (“Test”), and include all the created director’s, signature’s and shareholder’s IDs in the designated lists so that the sub-users will get linked with the SME Test.
If required you can create business SME Test’s identification and upload any supporting documents by using the same APIs mentioned in this section.
Below you can find the step-by-step instructions on how to create a business user.
To create a Director, Signature or Shareholder, send a POST request to /users endpoint and indicate relevant ‘user_type’ (DIRECTOR, SIGNATURE or SHAREHOLDER). Below you can find sample requests and responses with relevant parameters for each user type.
To create an identification, you should send a POST request to /users/{user_id}/identifications endpoint, where you should indicate a ‘type’ parameter, relevant to this specific sub-user. Below you can find the list of available identification types:
Name
Description
PASSPORT
Passport
VISA
Visa
NATIONAL_ID
National ID
TRADE_LICENSE
Trade license
COMMERCIAL_LICENSE
Commercial license
INCORPORATION_CERT
Company Certification of Incorporation
INCUMBENCY_CERT
Incumbency certificate
MEMORANDUM_ARTICLES
Memorandum and articles. Company Memorandum and Articles of Association/By-Laws
BANK_STATEMENT
Bank statement of 3 months. The size of the document should be up to 5 Mb.
ADDITIONAL
Additional document (other company legal document)
Below you can find an example for National ID identification creation:
Also here you can find an example for VISA identification creation:
You can create any of the identification types mentioned above by sending a POST request to /user/{user_id}/identification endpoint. Below you can find an example with Trade license:
After identification is created, you can upload the relevant documents. For this you should send a POST request to /users/{user_id}/identifications/{identification_id}/files endpoint.
Below you can find a sample request:
Now you can create a business user along with the details and sub-users, created in step 1. For this you should send a POST request to /users endpoint and indicate ‘user_type’ = BUSINESS. Below you can find a sample request and response.
The SME’s sub-user, their identifications, and a SME itself will be created with a status as PENDINGKYB and it will only transition to ACTIVE when processed and approved by the NymCard’s compliance team after considerable amount of validation.
If the documents are not verified due to any reason, the system will mark the status as SUSPENDED and status_reason_code as S5 - ‘Admin rejected due to ID verification failed’. It means that the additional document is requested by the NymCard’s compliance team. You would be required to provide the requested documents by using the ‘’ API as mentioned in section ‘.
