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

Parameters Type Description Default value
NotificationType string Three-digit unique identifier of notification. Numeric value “055” denotes the Authorisation notification. Blank
CardID integer Unique identifier of the card.
OTPCode string Unique 6-character, time-limited, one-time-use password sent to the registered mobile number.
OTPCodeExpiry string The date and time of expiry of the OTP in the format yyyyMMddHHmmss.
Mobile integer Mobile Number of the consumer. Blank
Email string Email Address of consumer. Blank
NotificationPreference Type integer Look up value that indicates the preference for medium of transmission of  the notification.
Value “ 1 ” = “ SMS ” and value “ 2 ” = “ Email ” .
1 or 2
DeviceType string Device type For Example
01 – Mobile Phone
02 – Tablet
03 – Watch
04 – Mobile Phone or Tablet
05 – Personal Computer

TokenRequestorCode string Token requestor code For Example ‘APLPAY’ OR ‘GGLPAY’ OR ‘SAMPAY
SecurityHash string String 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 name Value
NotificationType 055
CardID 1402
OTPCode 1122
OTPCodeExpiry 20180927213756
Mobile 919824561785
NotificationPreferenceType 1
DeviceType 1
TokenRequestorCode APLPAY
Security Hash a9237262e02077cc34459959246feb8a7740d6a0b9199ee74c3f022bb6ce8a25

To Generate the Security Hash

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

HashDataString : 55&1402&1122&20180927213756&919824561785&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : a9237262e02077cc34459959246feb8a7740d6a0b9199ee74c3f022bb6ce8a25

JSON Example

   "NotificationType" : "55",
   "CardID" : "1402",
   "OTPCode" : "1122",
   "OTPCodeExpiry" : "20180927213756",
   "Mobile" : "919824561785",
   "Email" : "",
   "NotificationPreferenceType" : "1",
   "DeviceType" : "1",
   "TokenRequestorCode" : "APLPAY",
   "SecurityHash" : "a9237262e02077cc34459959246feb8a7740d6a0b9199ee74c3f022bb6ce8a25"