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

Parameters Type Description Default value
NotificationType string Three-digit unique identifier of the notification. Numeric value “046” denotes the KYC notification. Blank
KYCCheckDate string The date and time of KYC check. The format is yyyyMMddHHmmss. Maximum length = 14 charcaters.
CardHolderId integer Unique identifier of the consumer. 0000000
KYCStatus integer The Look up value that denotes the KYC status of the consumer after completion of verification process.
SecurityHash string String value generated through hash logic with all of the above parameters (To verify the values posted on URL)

Lookup values for KYC status

KYC status Description
03 Refer – The status of new application that fails to reach a score value within the defined range of Pass and Restricted
04 Alert – 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.
05 Restricted – 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 name Value
NotificationType 046
KYCCheckDate 20161116063343
CardHolderId 48142
KYCStatus 03
SecurityHash 0a5a81254cc9c24322abb02cf02cb52d23304d8a8f83e4b17793dbb5c169a29f

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"
}