Token OTP notification

Contis API service notifies the consumer about OTP setting. The client must integrate the call back URL in the Contis API service so that consumer can receive the OTP on the mobile device.

Example of Token OTP notification parameters

ParametersTypeDescriptionDefault value
NotificationTypestringThree-digit unique identifier of notification. Numeric value “055” denotes the Authorisation notification.Blank
CardIDintegerUnique identifier of the card.
OTPCodestringUnique 6-character, time-limited, one-time-use password sent to the registered mobile number.
OTPCodeExpirystringThe date and time of expiry of the OTP in the format yyyyMMddHHmmss.
MobileintegerMobile Number of the consumer.Blank
EmailstringEmail Address of consumer.Blank
NotificationPreference TypeintegerLook up value that indicates the preference for medium of transmission of  the notification.
Value “ 1 ” = “ SMS ” and value “ 2 ” = “ Email ” .
1 or 2
DeviceTypestringDevice type For Example
01 – Mobile Phone
02 – Tablet
03 – Watch
04 – Mobile Phone or Tablet
05 – Personal Computer

TokenRequestorCodestringToken requestor code For Example ‘APLPAY’ OR ‘GGLPAY’ OR ‘SAMPAY
SecurityHashstringString value generated through hash logic with all of the above parameters (To verify the values posted on URL)Blank

Example of Token OTP notification

The table shows an example of an Token OTP notification sent to the consumer.

Parameter nameValue
NotificationType055
CardID1402
OTPCode1122
OTPCodeExpiry20180927213756
Mobile919824561785
Emailxyz@contis.com
NotificationPreferenceType1
DeviceType1
TokenRequestorCodeAPLPAY
Security Hasha9237262e02077cc34459959246feb8a7740d6a0b9199ee74c3f022bb6ce8a25

To Generate the Security Hash

Hash sequence : NotificationType&CardID&OTPCode&OTPCodeExpiry&Mobile&Email&NotificationPreferenceType&DeviceType&TokenRequestorCode&

HashDataString : 55&1402&1122&20180927213756&919824561785&xyz@contis.com&1&1&APLPAY&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : a9237262e02077cc34459959246feb8a7740d6a0b9199ee74c3f022bb6ce8a25

JSON Example

{
   "NotificationType" : "55",
   "CardID" : "1402",
   "OTPCode" : "1122",
   "OTPCodeExpiry" : "20180927213756",
   "Mobile" : "919824561785",
   "Email" : "xyz@contis.com",
   "NotificationPreferenceType" : "1",
   "DeviceType" : "1",
   "TokenRequestorCode" : "APLPAY",
   "SecurityHash" : "a9237262e02077cc34459959246feb8a7740d6a0b9199ee74c3f022bb6ce8a25"
}