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:
Hash sequence : NotificationType &GreyListCheckDate&CardHolderId&IsGreyAreaPostcode&HashPAN Key
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" }