Card status change notification

Provides an update when a card's status is changed to any of the following statuses:

Normal
Lost
Stolen
Issuer cancelled
Blocked
CVV2 tries exceeded

Notification Parameters

Parameter	Type	Description
NotificationType	string	Three-digit identifier of the notification type. "021" denotes the Card Status Change notification.
StatusChangeDate	string	The date and time of the status change, in `yyyyMMddHHmmss` format.
CardHolderID	integer	Unique indentifer of the consumer.
CardId	integer	Unique identifier of the card.
AccountNumber	string	Eight-digit account number of the consumer.
HashCardNumber	string	The 16-digit card number with readable first and last four digits and obscured eight digits in the middle.
OldCardStatus	integer	The two-digit card status before the status was changed.
NewCardStatus	integer	The two-digit card status after status after changed.
SecurityHash	string	Contains the hash of the payload values and your webhook security key, to verify the origin and integrity of the notification.

Example of Card status change notification

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

Copy

Copied

{
   "NotificationType" : "021",
   "StatusChangeDate" : "20160512063343",
   "CardHolderId" : "48142",
   "CardId" : "7461",
   "AccountNumber" : "00824023",
   "CardNumber" : "4745-****-****-3452",
   "OldCardStatus" : "01",
   "NewCardStatus" : "10",
   "SecurityHash" : "411c47ef10e04a90086de417d73ffbce"
}

Validating the notification security hash

Security Hash validation

See the respective guide for more information on calculating and verifying the notification security hash.

To compute the hash of the notification payload, concatenate the payload values in the following sequence, with your webhook security key as the final item:

Copy

Copied

<NotificationType>&<StatusChangeDate>&<CardHolderId>&<CardId>&<AccountNumber>&<CardNumber>&<OldCardStatus>&<NewCardStatus>&<webhook-security-key>

The payload values above and example webhook security key of abcdefghijklmnop, will produce the following hash input:

Copy

Copied

021&20160512063343&48142&7461&00824023&4745-****-****-3452&01&10&abcdefghijklmnop