Grey list check notification

Contis API service notifies API client if the customer details are a possible fraud risk.

The notification contains information about:

  • The date the fraud database check performed
  • Confirmation whether customer is ‘in’ or ‘not in’ the fraud database

Grey list check notification parameters

PARAMETERS TYPE DESCRIPTION DEFAULT VALUE
NotificationType string Three-digit unique identifier of the notification. Numeric value “048” denotes 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 database of possible fraud risk. 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. The value 1 of the Boolean “IsGreyAreaPostcode” confirms that the customer exists in the database of possible fraudulent details.

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&HashPANKey

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