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.