KYC procedures

What is a Know Your Customer (KYC) ?

Every consumer who which to open a bank account need to go though a Know Your Customer (KYC) procedure.

We strongly recommand you tu ask your enduser to do it on his mobile. Picture quality are much better and review process will be more efficient.

This procedure is mandatory to be able to create a Ledger. To perform a KYC, your consumer phone must be verified.

How to request a KYC ?

There are two ways to integrate LinkCy's KYC. You can request a clickable link which will bring you on internet, then you can use a QR code to do it on mobile. Or you can request the necessary body to run the SDK.

SDKs are available into the librairy.

Name	Type	Description
consumerId	string (uuid)	Id of the consumer doing the KYC (Will be ignored and deducted from current authenticated user if end-user).
kycConfiguration	object	Configure the access type of the KYC.

Exemple request body

{
  "consumerId": "9e675a24-20d6-4913-9836-f861cd23e89e",
  "kycConfiguration": {
    "accessType": "LINK",
    "urlOnComplete": "https://google.com",
    "urlOnFailure": "https://google.com"
  }
}

Depending on the Endsuer type, you should provide a consumerId (for a Consumer) or a relatedPersonId (for a Corporate)

In the case you request a KYC link, you can set up a success and a failure URL.

KYC process

Once the KYC verification has started (by clicking the LINK or using the SDK), it is pretty self-explanatory in the interface :

Enduser will have to take a picture of one of its ID document.
Then, most of the time, he will have to record liveness videos. Instructions are directly in the KYC interface.

The language of the interface can be changed directly in the tool. If you feel that a language is missing, please contact us.

KYC's Status

You have few status available for the KYC. The status is available on the Enduser information.

KYC Status	Description
NOT_STARTED	Available when you have not requested yet a KYC link or SDK access
CREATED	Available when a link or a SDK access have been requested
PROCESSING	KYC is completed, IA and the team are working on it to have it validated
PENDING_REVIEW	Unfortunately, we need to proceed to a review
ABORTED	The Enduser has not finished the KYC procedure, you can generate a new link / access
VALIDATED	Perfect, KYC is validated
DECLINED	Unfortunately, your Consumer does not match the requirements
NOT_REQUIRED	KYC is not required for this Enduser

KYC Application

Each KYC performed by a consumer will create a kycApplication.

You can list all the kycApplication related to a consumer with the "List KYC applications" endpoint.

Once a kycApplication status (kycStatus) is set to VALIDATED, all the information are carried over to the consumer and its own kyc status is set to VALIDATED.

You can find the last kycApplication of a consumer on the consumer object : field kycApplicationId