Account status change notification

Contis API service generates a notification whenever the status of an account is changed and posts it on the URL of the API client.

The notification contains information about:

  • Change in status of the card
  • The date of change of the status of the card

The client is notified whenever the status of an account is changed to:

  • Suspended
  • Frozen
  • Live from Suspended
  • Live from Frozen

Notification parameters for change in account status

ParametersTypeDescriptionDefault value
NotificationTypestringThree-digit unique identifier of the notification. Numeric value “022” denotes Account Status Change Status notification.Blank
StatusChangeDatestringThe date and time when the status of the account is changed. The format is yyyyMMddHHmmss. Maximum character length = 14. 
CardHolderIdintegerUnique identifier of the consumer. 
AccountNumberstringEight-digit account number of the consumer.00000000
OldAccountStatusintegerTwo-digit unique identifier of the “status of the account” before the status is changed.00
NewAccountStatusintegerTwo-digit unique identifier of the “status of the account” after the status is changed.00
SecurityHashstringString value generated through hash logic with all the above parameters (To verify the values posted on URL)Blank

Lookup values for account status

Account statusDescription
01Live
02Suspended
05Frozen
 

Example of account status change notification

This is an example of a notification about account reactivation. The status of the account is changed from Suspended (02) to Live (01).

Parameter nameValue
NotificationType022
StatusChangeDate20160512063400
CardHolderId53040
AccountNumber00868152
OldAccountStatus02
NewAccountStatus01
SecurityHashc9b869536616e505c64162e2317c59d8

To generate the Security Hash

Hash sequence : NotificationType&StatusChangeDate&CardHolderId&AccountNumber&OldAccountStatus&NewAccountStatus&HashPAN Key


    HashDataString :022&20160512063400&53040&00868152&02&01&
    Key :abcdefghijklmnop  
    HashGenerationData : HashDataString + SecurityKey
    Hash :c9b869536616e505c64162e2317c59d8

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
Account status change

To send notification on account status changes to:

  1. Suspended
  2. Frozen
  3. From Suspended to Live
  4. From Frozen to Live
22