Contis API service notifies client about consumer’s HOSC status after the completion of HOSC verification process.
The notification contains information about:
- Date of HOSC check
- The status of HOSC check – Match HOSC or match swear
The KYC status can be – Refer, Alert or Restricted.
The parameters of the notification are shown in the table.
Parameters | Type | Description | Default Value |
---|---|---|---|
NotificationType | string | Three-digit unique identifier of the notification. Numeric value “047” identifies HOSC check notification. | Blank |
HOSCCheckDate | string | The date and time of HOSC check. The format is yyyyMMddHHmmss. Maximum character length = 14. | |
CardHolderId | integer | Unique identifier of the consumer | 0000000 |
HOSCStatus | integer | The status of the consumer after completion of HOSC verification | |
SecurityHash | string | String value generated through hash logic with all of the above parameters(To verify the values posted on URL) |
PARAMETERS OF HOSC CHECK NOTIFICATION
KYC Status | Description |
---|---|
04 | Match HOSC |
02 | Match Swear |
LOOK UP VALUES FOR HOSC STATUS
Example of HOSC status notification
The table is an example of HOSC notification to an API client that consumer’s credential has been matched in the HOSC database.
Parameter Name | Value |
---|---|
NotificationType | 047 |
HOSCCheckDate | 20161116063343 |
CardHolderId | 48142 |
HOSCStatus | 02 |
SecurityHash | 1588d9c79ff4fcfcfcd77aed7a456c27047d569515a2e3715f111da8b792381d |
NOTIFICATION ABOUT HOSC STATUS
To generate the Security Hash:
Hash sequence: NotificationType&HOSCCheckDate&CardHolderId&HOSCStatus&HashPAN Key
HashDataString : 047&20161116063343&48142&2& SecurityKey : abcdefghijklmnop HashGenerationData : HashDataString + SecurityKey Hash : 1588d9c79ff4fcfcfcd77aed7a456c27047d569515a2e3715f111da8b792381d
Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.
JSON Example
{ "NotificationType" : "047", "HOSCCheckDate" : "20161116063343", "CardHolderId" : "48142", "HOSCStatus" : "02", "SecurityHash" : "1588d9c79ff4fcfcfcd77aed7a456c27047d569515a2e3715f111da8b792381d" }