KYC Check Notification

Provides notification of the KYC status of a consumer following completion of the KYC process.

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

Notification parameters

Parameter	Type	Description
NotificationType	string	Three-digit identifier of the notification type. "046" denotes the KYC notification.
KYCCheckDate	string	The date and time of KYC check in `yyyyMMddHHmmss` format.
CardHolderId	integer	Unique identifier of the user.
KYCStatus	string	Denotes the KYC status of the consumer after completion of the verification process.
SecurityHash	string	Contains the hash of the payload values and your webhook security key, to verify the origin and integrity of the notification.

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.

Copy

Copied

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

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

Validating the notification security hash

Security Hash validation

See the respective guide for more information on calculating and verifying the notification security hash.

To compute the hash of the notification payload, concatenate the payload values in the following sequence, with your webhook security key as the final item:

Copy

Copied

<NotificationType>&<KYCCheckDate>&<CardHolderId>&<KYCStatus>&<webhook-security-key>

The payload values above and example webhook security key of abcdefghijklmnop, will produce the following hash input:

Copy

Copied

046&20161116063343&48142&03&abcdefghijklmnop