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 |
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 |
xyz@contis.com | |
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&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" }