MdlAddDevice (service) [v1]
This command is deprecated! Use MdlAddDevice (service) [v2] instead!
API version: 1
Availability: DIGIPASS Gateway 4.1 and later
Authentication: Basic HTTP authentication using the front-end API key.
The MdlAddDevice registers a new device that supports Secure Channel activation. It retrieves Activation Message 2 (instance).
URL
https://dpgateway_host:dpgateway_port/rest/activation/MdlAddDevice
Request
MdlAddDevice parameters
| Parameter name |
Data type |
Description |
| registrationID
|
String |
Required. The unique identifier of a user for a given activation process. |
| deviceCode
|
String |
Required. The device code generated by the mobile application using the Digipass SDK. This is needed for validation and derivation purposes. |
Example
{
"registrationID": "myRegistrationID",
"deviceCode": "12345678901234567890123456"
}
Response
MdlAddDevice return values
| Return value |
Data type |
Description |
| errorCode
|
Integer |
The return code provided by OneSpan Authentication Server. 0 is returned in case of success.
|
| errorMessage
|
String |
The error message provided by OneSpan Authentication Server. STAT_SUCCESS is returned in case of success.
|
| instanceActivationMessage
|
String |
The instance activation message (i.e. Activation Message 2). |
Example
{
"errorCode": 0,
"errorMessage": "STAT_SUCCESS",
"instanceActivationMessage": "82A53BF7E525012E2488BA51E9E33655..."
}