HOSC check notification

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