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 |
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 |
NOTIFICATION ABOUT HOSC STATUS
To generate the Security Hash:
Hash sequnse : NotificationType&HOSCCheckDate&CardHolderId&HOSCStatus&HashPAN Key
HashDataString :063&55320&20191129063343&CF24 3DG&The Business Centre&Studio 103&61 Wellfield Road&Cardiff&Roath&Roath&826&subbuilding example&substreet example&Bedfordshire& SecurityKey : abcdefghijklmnop HashGenerationData : HashDataString + SecurityKey Hash : 411c47ef10e04a90086de417d73ffbce
Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.