Card status change notification

The Contis API service generates a notification whenever the status of the card is changed and posts it on client’s URL. The notification contains information about:

  • Change in status of the card
  • The date and time when status was changed

The client is notified whenever the status of the card is changed to:

  • Normal
  • Blocked due to PIN tries exceeded
  • Lost
  • Stolen
  • Issuer cancelled
  • Blocked
  • CVV2 tries exceeded
Table shows the parameters of notification about card status change
ParametersTypeDescriptionDefault value
NotificationTypeStringThree-digit unique identifier of the notification. Numeric value “021” denotes the Card Status Change notification.Blank
StatusChangeDatestringThe date and time when the status of the card is changed. The format is yyyyMMddHHmmss. Maximum length = 14 characters. 
CardHolderIDintegerUnique indentifer of the consumer. 
CardIdintegerUnique identifier of the card. 
AccountNumberstringEight-digit account number of the consumer.00000000
HashCardNumberstringThe 16-digit card number with readable first and last four digits and obscured eight digits in the middle.0000-****-****-0000
OldCardStatusintegerTwo-digit unique identifier of the “status of the card” before the status is changed.00
NewCardStatusintegerTwo-digit unique identifier of the “status of the card” after status is changed.00
SecurityHashStringString value generated through hash logic with all of the above parameters(To verify the values posted on URL)Blank

The Table shows look up values for different status of the card, e.g. value “10” denotes that a card is blocked.

Card statusDescription
01Unblock a blocked card or activate an inactive card
02Blocked due to PIN tries exceeded
10Block
05Lost
06Stolen
08/31Cancelled
34CVV2 Tries Exceeded

Example of blocked card notification

This is an example of notification about a blocked card. The status of the card is changed from Active (01) to Blocked (10).

Parameter nameValue
NotificationType021
StatusChangeDate20160512063343
CardHolderId48142
CardId7461
AccountNumber00824023
CardNumber4745-****-****-3452
OldCardStatus01
NewCardStatus10
Security Hash411c47ef10e04a90086de417d73ffbce

To Generate the Security Hash

HashDataString :021&20160512063343&48142&7461&00824023&4745-****-****-3452&01&10&
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.

Notification types summary

NotificationDescription typeTypeCode
Card status change

To send notification on card status changes to:

  • Block
  • Unblock
  • Block due to PIN tries exceeded
021