Grey list check notification

Contis API service notifies API client if the postcode in the consumer’s address matches with Contis grey list.

The notification contains information about:

• Date of postcode verification in the Grey list
• Confirmation whether postcode is ‘in’ the or ‘not in’ the Contis postcode grey list

Grey list check notification parameters

Parameters	Type	Description	Default value
NotificationType	string	Three-digit unique identifier of the notification. Numeric value “048” denotes the the grey list check notification.	Blank
GreyListCheckDate	string	The date and time of HOSC check. The format is yyyyMMddHHmms. Maximum length = 14 characters.
CardHolderId	integer	Unique identifier of the consumer.	0000000
IsGreyAreaPostcode	integer	Boolean that identifies whether the postcode in consumer’s address “exists” or “does not exist” in Contis Postcode Grey List. Value 1= “true”= “exists”. Value = 0 = “false”= “does not exist”.
SecurityHash	string	String value generated through hash logic with all of the above parameters (To verify the values posted on URL)

Example of grey list check notification

The table is an example of grey list check notification. The value 1 of the Boolean “IsGreyAreaPostcode” confirms that postcode of the consumer exists in Contis postcode grey list.

Grey list check notification

Parameter name	Value
NotificationType	048
GreyListCheckDate	20161116063343
CardHolderId	48142
IsGreyAreaPostcode	1
SecurityHash	c748390ca37d8677ea86ac4007274820524671f8d716db26297ee2766d42e2dc

To generate the Security Hash:

HashDataString : 048&20161116063343&48142&1&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : c748390ca37d8677ea86ac4007274820524671f8d716db26297ee2766d42e2dc

Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.

JSON Example

{
   "NotificationType" : "048",   
   "GreyListCheckDate" : "20161116063343",
   "CardHolderId" : "48142",
   "IsGreyAreaPostcode" : "1",
   "SecurityHash" : "c748390ca37d8677ea86ac4007274820524671f8d716db26297ee2766d42e2dc"
}