User contact update notification

Provides notification when a user's contact information - mobile number, email address or address is updated by Solaris. Each notification type has its own respective payload.

info

Please note these notifications will not be sent when user contact information is updated via the API. These will only be sent when the respective updates are handled and made by Solaris directly.

Mobile number update notification

User's mobile number update notification parameters

Parameters Type Description
NotificationType string Three-digit identifier of the notification type. "062" denotes the mobile number update notification.
CardHolderID integer Unique identifier of the user whose mobile number was changed.
ChangeDateTime string The date and time the mobile number was changed, in yyyyMMddHHmmss format.
NewMobileNumber string User's new Mobile number which is updated. Mobile number is with country code prefix.
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 updated mobile number notification

Copy
Copied
{
   "NotificationType" : "062",
   "CardHolderID" : "55320",
   "ChangeDateTime" : "20191129063343",
   "NewMobileNumber" : "449726915389",
   "SecurityHash" : "f507f3656ba5fcc8edb63f50fc24543a6c1acb65ee6d31913aa9180535987984"
}

Validating 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>&<CardHolderID>&<ChangeDateTime>&<NewMobileNumber>&<webhook-security-key>

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

Copy
Copied
062&55320&20191129063343&449726915389&abcdefghijklmnop

Email address update notification

User's email address update notification parameters

Parameters Type Description
NotificationType string Three-digit identifier of the notification type. "063" denotes the email address update notification.
CardHolderID integer Unique identifier of the user whose email address was changed.
ChangeDateTime string The date and time the email address was changed, in yyyyMMddHHmmss format.
NewEmailAddress string User's new Email address which is updated.
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 updated email address notification

Copy
Copied
{
   "NotificationType" : "063",
   "CardHolderID" : "55320",
   "ChangeDateTime" : "20191129063343",
   "NewEmailAddress" : "test.user@Solaris.com",
   "SecurityHash" : "b7dcc0527a607e6e09d6b5bfe34ffa9fb2648e98bc3c8e8a0220cec64b5d8784"
}

Validating 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>&<CardHolderID>&<ChangeDateTime>&<NewEmailAddress>&<webhook-security-key>

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

Copy
Copied
063&55320&20191129063343&test.user@Solaris.com&abcdefghijklmnop

Address update notification

User's address update notification parameters

Payload structure

Depending on your program configuration, certain address fields listed below (marked with "*") will not be included in the notification payload. If the field is configured for your program, it will be empty if unchanged by the update.

Parameters Type Description
NotificationType string Three-digit identifier of the notification type. "064" denotes the address update notification.
CardHolderID integer Unique identifier of the user whose address was changed.
ChangeDateTime string The date and time the address was changed, in yyyyMMddHHmmss format.
PostCode string Postcode of the address.
BuildingName * string Name of the building of the address.
BuildingNo * string Building Number of the address.
Street * string Street name of the address.
District * string District name of the address.
Town * string Town name of the address.
Region * string Region of address.
CountryISOCode* string ISO Digital code of Country.
Subbuilding * string Sub building name of the address.
Substreet * string Sub street name of the address.
County * string County name of the address.
Organization * string Organization name of the address.
AddressLine1 * string Address Line 1 of the address.
AddressLine2 * string Address Line 2 of the address.
AddressLine3 * string Address Line 3 of the address.
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 updated address notification

Please note in this example payload:

  • The AddressLine1 , AddressLine2 , AddressLine3 fields are not configured for the program and therefore not included in the payload.
  • The Organization field was unchanged by the update and is empty ("").
Copy
Copied
{
   "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",
   "SecurityHash" : "f4e9c549b8e5dffba2755b2a06155be9fdcaadb185e79a1dd1686407304f12bf"
}

Validating the user address update notification security hash

The logic for validating the security hash of this notification is the same as for all other notification types. Please note however that due to the variation in payload fields, this logic will need to consider the fields included in your specific program configuration.

Solaris is the brand name for the regulated entities Contis Financial Services Ltd and UAB „Finansinės paslaugos „Contis“, which are part of the Solaris Group.