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
Parameters | Type | Description | Default value |
NotificationType | String | Three-digit unique identifier of the notification. Numeric value “021” denotes the Card Status Change notification. | Blank |
StatusChangeDate | string | The date and time when the status of the card is changed. The format is yyyyMMddHHmmss. Maximum length = 14 characters. | |
CardHolderID | integer | Unique indentifer of the consumer. | |
CardId | integer | Unique identifier of the card. | |
AccountNumber | string | Eight-digit account number of the consumer. | 00000000 |
HashCardNumber | string | The 16-digit card number with readable first and last four digits and obscured eight digits in the middle. | 0000-****-****-0000 |
OldCardStatus | integer | Two-digit unique identifier of the “status of the card” before the status is changed. | 00 |
NewCardStatus | integer | Two-digit unique identifier of the “status of the card” after status is changed. | 00 |
SecurityHash | String | String 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 status | Description |
01 | Unblock a blocked card or activate an inactive card |
02 | Blocked due to PIN tries exceeded |
10 | Block |
05 | Lost |
06 | Stolen |
08/31 | Cancelled |
34 | CVV2 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 name | Value |
NotificationType | 021 |
StatusChangeDate | 20160512063343 |
CardHolderId | 48142 |
CardId | 7461 |
AccountNumber | 00824023 |
CardNumber | 4745-****-****-3452 |
OldCardStatus | 01 |
NewCardStatus | 10 |
Security Hash | 411c47ef10e04a90086de417d73ffbce |
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
Notification | Description type | TypeCode |
Card status change | To send notification on card status changes to:
| 021 |