Contact update notification

Contis API service notifies to the client whenever the user’s contact detail has been updated from any of Contis system.

Contact detail includes Mobile number, Email and Address of user.

Mobile number update notification

User’s mobile number update notification parameters

Parameters Type Description Default value
NotificationType string Three-digit unique identifier of the notification. Numeric value “062” denotes the mobile change
notification.

CardHolderID integer Unique identifier of the consumer whose mobile number is changed.
ChangeDateTime string The date and time when the mobile number is changed. The format is yyyyMMddHHmmss. Maximum length = 14
characters.

NewMobileNumber string User’s new Mobile number which is updated. Mobile number is with country code prefix.
SecurityHash string String value generated through hash logic with all of the above parameters(To verify the values posted
on URL)

Example of updated mobile number notification

This is an example of the notification for the user’s updated mobile number.

Parameter name Value
NotificationType 062
CardHolderID 55320
ChangeDateTime 20191129063343
NewMobileNumber 449726915389
SecurityHash a2eb87beda967daf5bde610a594513ce

To generate the Security Hash

Hash sequence: NotificationType&CardHolderID&ChangeDateTime&NewMobileNumber&HashPAN Key

HashDataString :062&55320&449726915389&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : a2eb87beda967daf5bde610a594513ce

Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.

JSON Example

{
   "NotificationType" : "062",
   "CardHolderID" : "55320",
   "ChangeDateTime" : "20191129063343",
   "NewMobileNumber" : "449726915389",
   "SecurityHash" : "a2eb87beda967daf5bde610a594513ce"
}

Email address update notification

The user’s email address update notification parameters

Parameters Type Description Default value
NotificationType string Three-digit unique identifier of the notification. Numeric value “063” denotes the email change
notification.

CardHolderID integer Unique identifier of the consumer whose email address is changed.
ChangeDateTime string The date and time when the email address is changed. The format is yyyyMMddHHmmss. Maximum length = 14 characters.
NewEmailAddress string User’s new Email address which is updated.
SecurityHash string String value generated through hash logic with all of the above parameters(To verify the values posted on URL)

Example of updated email address of User notification

This is an example of for updated email address of user notification.

Parameter name Value
NotificationType 063
CardHolderID 55320
ChangeDateTime 20191129063343
NewEmailAddress test.user@contis.com
SecurityHash a2eb87beda967daf5bde610a594513ce

To generate the Security Hash:

Hash sequence: NotificationType&CardHolderID&ChangeDateTime&NewEmailAddress&HashPAN Key

HashDataString :063&55320&test.user@contis.com&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : a2eb87beda967daf5bde610a594513ce

Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.Address Update notification.

JSON Example

{
   "NotificationType" : "063",
   "CardHolderID" : "55320",
   "ChangeDateTime" : "20191129063343",
   "NewEmailAddress" : "test.user@contis.com",
   "SecurityHash" : "a2eb87beda967daf5bde610a594513ce"
}

Address update notification

The user’s address update notification parameters

Parameters Type Description Default value
NotificationType string Three-digit unique identifier of the notification. Numeric value “064” denotes the address change
notification.

CardHolderID integer Unique identifier of the consumer whose address is changed.
ChangeDateTime string The date and time when the address is changed. The format is yyyyMMddHHmmss. Maximum length = 14 characters.
PostCode string Postcode of area in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

BuildingName string Name of the building in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

BuildingNo string Building Number in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Street string Street name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

District string District name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Town string Town name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Region string Region of address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

CountryISOCode string ISO Digital code of Country.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Subbuilding string Sub building name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Substreet string Sub street name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

County string County name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Organization string Organization name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

AddressLine1 string Address Line 1 in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

AddressLine2 string Address Line 2 in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

AddressLine3 string Address Line 3 in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

SecurityHash string String value generated through hash logic with all of the above parameters(To verify the values posted on URL)

Example of Updated Address of User notification

This is an example of the notification for an updated email address of the user.

Parameter name Value
NotificationType 064
CardHolderID 55320
ChangeDateTime 20191129063343
Postcode CF24 3DG
BuildingName The Business Centre
BuildingNo Studio 103
Street 61 Wellfield Road
District Cardiff
Town Roath
Region Roath
CountryISOCode 826
Subbuilding subbuilding example
Substreet substreet example
County Bedfordshire
Organization
AddressLine1
AddressLine2
AddressLine3
SecurityHash a2eb87beda967daf5bde610a594513ce

To generate the Security Hash:

Hash sequence: NotificationType&CardHolderID&ChangeDateTime&Postcode&BuildingName&BuildingNo&Street&District&Town&Region&CountryISOCode&Subbuilding&street&County&Organisation&AddressLine1&AddressLine2&AddressLine3&HashPAN Key

HashDataString :064&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 : a2eb87beda967daf5bde610a594513ce

Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.

JSON Example

{
   "NotificationType" : "064",
   "CardHolderId" : "55320",
   "ChangeDateTime" : "20191129063343",
   "Postcode" : "CF24 3DG",
   "BuildingName" : "The Business Centre",
   "BuildingNo" : "Studio 103",
   "Street" : "61 Wellfield Road",
   "District" : "Cardiff",
   "Town" : "Roath",
   "Region" : "Roath",
   "Organization:": "",
   "CountryISOCode" : "826",
   "Subbuilding" : "subbuilding example",
   "Substreet" : "substreet example",
   "County" : "Bedfordshire",
   "AddressLine1": "",
   "AddressLine2": "",
   "AddressLine3": "",
   "SecurityHash" : "a2eb87beda967daf5bde610a594513ce"
}

Contis API service notifies to the client whenever the user’s contact detail has been updated from any of Contis system.

Contact detail includes Mobile number, Email and Address of user.

Mobile number update notification

User’s mobile number update notification parameters

Parameters Type Description Default value
NotificationType string Three-digit unique identifier of the notification. Numeric value “062” denotes the mobile change
notification.

CardHolderID integer Unique identifier of the consumer whose mobile number is changed.
ChangeDateTime string The date and time when the mobile number is changed. The format is yyyyMMddHHmmss. Maximum length = 14
characters.

NewMobileNumber string User’s new Mobile number which is updated. Mobile number is with country code prefix.
SecurityHash string String value generated through hash logic with all of the above parameters(To verify the values posted
on URL)

Example of updated mobile number notification

This is an example of the notification for the user’s updated mobile number.

Parameter name Value
NotificationType 062
CardHolderID 55320
ChangeDateTime 20191129063343
NewMobileNumber 449726915389
SecurityHash a2eb87beda967daf5bde610a594513ce

To generate the Security Hash

Hash sequence: NotificationType&CardHolderID&ChangeDateTime&NewMobileNumber&HashPAN Key

HashDataString :062&55320&449726915389&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : a2eb87beda967daf5bde610a594513ce

Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.

JSON Example

{
   "NotificationType" : "062",
   "CardHolderID" : "55320",
   "ChangeDateTime" : "20191129063343",
   "NewMobileNumber" : "449726915389",
   "SecurityHash" : "a2eb87beda967daf5bde610a594513ce"
}

 

Email address update notification

The user’s email address update notification parameters

Parameters Type Description Default value
NotificationType string Three-digit unique identifier of the notification. Numeric value “063” denotes the email change
notification.

CardHolderID integer Unique identifier of the consumer whose email address is changed.
ChangeDateTime string The date and time when the email address is changed. The format is yyyyMMddHHmmss. Maximum length = 14 characters.
NewEmailAddress string User’s new Email address which is updated.
SecurityHash string String value generated through hash logic with all of the above parameters(To verify the values posted on URL)

Example of updated email address of User notification

This is an example of for updated email address of user notification.

Parameter name Value
NotificationType 063
CardHolderID 55320
ChangeDateTime 20191129063343
NewEmailAddress test.user@contis.com
SecurityHash a2eb87beda967daf5bde610a594513ce

To generate the Security Hash:

Hash sequence: NotificationType&CardHolderID&ChangeDateTime&NewEmailAddress&HashPAN Key

HashDataString :063&55320&test.user@contis.com&
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.Address Update notification.

JSON Example

{
   "NotificationType" : "063",
   "CardHolderID" : "55320",
   "ChangeDateTime" : "20191129063343",
   "NewEmailAddress" : "test.user@contis.com",
   "SecurityHash" : "a2eb87beda967daf5bde610a594513ce"
}

 

Address update notification

The user’s address update notification parameters

Parameters Type Description Default value
NotificationType string Three-digit unique identifier of the notification. Numeric value “064” denotes the address change
notification.

CardHolderID integer Unique identifier of the consumer whose address is changed.
ChangeDateTime string The date and time when the address is changed. The format is yyyyMMddHHmmss. Maximum length = 14 characters.
PostCode string Postcode of area in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

BuildingName string Name of the building in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

BuildingNo string Building Number in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Street string Street name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

District string District name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Town string Town name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Region string Region of address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

CountryISOCode string ISO Digital code of Country.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Subbuilding string Sub building name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Substreet string Sub street name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

County string County name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

Organization string Organization name in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

AddressLine1 string Address Line 1 in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

AddressLine2 string Address Line 2 in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

AddressLine3 string Address Line 3 in address.
Empty value if not updated and parameter will be hide in request if not supported by scheme (Generate HashDataString accordingly).

SecurityHash string String value generated through hash logic with all of the above parameters(To verify the values posted on URL)

Example of Updated Address of User notification

This is an example of the notification for an updated email address of the user.

Parameter name Value
NotificationType 064
CardHolderID 55320
ChangeDateTime 20191129063343
Postcode CF24 3DG
BuildingName The Business Centre
BuildingNo Studio 103
Street 61 Wellfield Road
District Cardiff
Town Roath
Region Roath
CountryISOCode 826
Subbuilding subbuilding example
Substreet substreet example
County Bedfordshire
Organization
AddressLine1
AddressLine2
AddressLine3
SecurityHash a2eb87beda967daf5bde610a594513ce

To generate the Security Hash:

Hash sequence: NotificationType&CardHolderID&ChangeDateTime&Postcode&BuildingName&BuildingNo&Street&District&Town&Region&CountryISOCode&Subbuilding&street&County&Organisation&AddressLine1&AddressLine2&AddressLine3&HashPAN Key

HashDataString :064&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 : a2eb87beda967daf5bde610a594513ce

Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.

JSON Example

{
   "NotificationType" : "064",
   "CardHolderId" : "55320",
   "ChangeDateTime" : "20191129063343",
   "Postcode" : "CF24 3DG",
   "BuildingName" : "The Business Centre",
   "BuildingNo" : "Studio 103",
   "Street" : "61 Wellfield Road",
   "District" : "Cardiff",
   "Town" : "Roath",
   "Region" : "Roath",
   "Organization:": "",
   "CountryISOCode" : "826",
   "Subbuilding" : "subbuilding example",
   "Substreet" : "substreet example",
   "County" : "Bedfordshire",
   "AddressLine1:": "",
   "AddressLine2:": "",
   "AddressLine3:": "",
   "SecurityHash" : "a2eb87beda967daf5bde610a594513ce"
}