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

ParametersTypeDescriptionDefault value
NotificationTypestringThree-digit unique identifier of the notification. Numeric value “048” denotes the the grey list check notification.Blank
GreyListCheckDatestringThe date and time of HOSC check. The format is yyyyMMddHHmms. Maximum length = 14 characters. 
CardHolderIdintegerUnique identifier of the consumer.0000000
IsGreyAreaPostcodeintegerBoolean 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”. 

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 nameValue

To generate the Security Hash:

Hash sequnse NotificationType&GreyListCheckDate&CardHolderId&IsGreyAreaPostcode&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.