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