User login block/unblock notification

Contis API service notifies the client whenever the user’s login is blocked or unblocked from the Contis platform.

User’s login block/unblock notification parameters

ParametersTypeDescriptionDefault value
NotificationTypestringThree-digit unique identifier of the notification. Numeric value “061” denotes the Login Status Change notification.
CardHolderIDintegerUnique identifier of the consumer.
LoginBlockStatusstringTwo-digit unique identifier that denotes the “status of block/unblock”. Block = 01, Unblock = 00
DescriptionstringDescription of login block reason and unblock.
SecurityHashstringString value generated through hash logic with all of the above parameters(To verify the values posted on URL)

Lookup values for login status

The table shows lookup values for login blocked/unblocked status codes, e.g. value “01” denotes that a login has been blocked.

Login statusDescription
00Unblocked
01Blocked

Example of login block notification

This is an example of a notification for a blocked user. The status of the user is changed from Unblocked(00) to Blocked (01).

Parameter nameValue
NotificationType061
CardHolderID55320
LoginBlockStatus01
DescriptionUser blocked, Invalid SCA attempts
SecurityHash411c47ef10e04a90086de417d73ffbce

To generate the Security Hash:

Hash sequence :  NotificationType&CardHolderID&LoginBlockStatus&Description&HashPAN Key

HashDataString :061&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.

JSON Example

{
   "NotificationType": "061",
   "CardHolderID": "55320",
   "LoginBlockStatus": "01",
   "Description" : "User blocked, Invalid SCA attempts",
   "SecurityHash" : "411c47ef10e04a90086de417d73ffbce"
}


Example of login unblock notification

This is an example notification for an unblocked user. The status of the user is changed from Blocked(01) to Unblocked (00).

Parameter nameValue
NotificationType061
CardHolderID55320
LoginBlockStatus00
DescriptionUser Unblocked
SecurityHash411c47ef10e04a90086de417d73ffbce

To generate the Security Hash:

Hash sequence :  NotificationType&CardHolderID&LoginBlockStatus&Description&HashPAN Key

HashDataString :061&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.

JSON Example

{
   "NotificationType": "061",
   "CardHolderID": "55320",
   "LoginBlockStatus": "00",
   "Description": "User Unblocked",
   "SecurityHash": "411c47ef10e04a90086de417d73ffbce"
}