KYC check notification

Contis API service generates a notification about the KYC status of the consumer once the KYC process is completed.

The notification contains information about:

  • Date of KYC check
  • Status of consumer’s KYC after completion of verification process

The KYC status can be – Refer, Alert or Restricted.

Parameters of notification for KYC status

ParametersTypeDescriptionDefault value
NotificationTypestringThree-digit unique identifier of the notification. Numeric value “046” denotes the KYC notification.Blank
KYCCheckDatestringThe date and time of KYC check. The format is yyyyMMddHHmmss. Maximum length = 14 charcaters.
CardHolderIdintegerUnique identifier of the consumer.0000000
KYCStatusintegerThe Look up value that denotes the KYC status of the consumer after completion of verification process.
SecurityHashstringString value generated through hash logic with all of the above parameters (To verify the values posted on URL)

Lookup values for KYC status

KYC statusDescription
03Refer – The status of new application that fails to reach a score value within the defined range of Pass and Restricted
04Alert – The status of the new application that fails to get either “Refer” or “Restricted” status. This KYC status is manually generated by the staff member and has the authority to assign “Alert” status to the new user.
05Restricted – The status of new application, whose KYC score or value cannot be configured as it is only read only

Example of KYC status notification

This is an example of KYC notification about granting of KYC status – Refer – to consumer after completion of the verification process.

Parameter nameValue
NotificationType046
KYCCheckDate20161116063343
CardHolderId48142
KYCStatus03
SecurityHash0a5a81254cc9c24322abb02cf02cb52d23304d8a8f83e4b17793dbb5c169a29f

To generate the Security Hash:

Hash sequence: NotificationType&KYCCheckDate&CardHolderId&KYCStatus&HashPAN Key

HashDataString : 046&20161116063343&48142&3&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : 0a5a81254cc9c24322abb02cf02cb52d23304d8a8f83e4b17793dbb5c169a29f

Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.

JSON Example

{
   "NotificationType" : "046",
   "KYCCheckDate" : "20161116063343",
   "CardHolderId" : "48142",
   "KYCStatus" : "03",
   "SecurityHash" : "0a5a81254cc9c24322abb02cf02cb52d23304d8a8f83e4b17793dbb5c169a29f"
}