API version: 2
Availability: DIGIPASS Gateway 5.0 and later
Authentication: Basic HTTP authentication using the front-end API key.
The DSAPPMdlAddDevice service registers a new device that supports Secure Channel activation.
URL
https://dpgateway_host:dpgateway_port/rest/v2/provisioning /DSAPPMdlAddDevice
Request
DSAPPMdlAddDevice parameters | ||
Parameter name | Data type | Description |
|---|---|---|
deviceCode | String | Required. The device code generated by the DSAPP SDK. |
initialVector | String | Required. The updated initial vector used by the mobile application using the DSAPP SDK. |
nonce | String | Required. The updated encrypted server nonce used by the mobile application using the DSAPP SDK. |
registrationIdentifier | String | Required. The unique identifier of a user for a given activation process. It is returned by DSAPPRegister. |
description | String | Optional. The description of the Digipass instance being activated. Up to 255 characters. Special characters are replaced with spaces. |
Example
{
"registrationIdentifier": "e3wfISG9",
"nonce": "5B983EE185B954A461CEFEECEBBBF214",
"initialVector": "43B525454EFA11CE0F5D1EBFAC5D9127",
"deviceCode": "6887133123"
"description": "myDigipassInstance"
}Response
DSAPPRegister return values | |
Return value | Description |
|---|---|
resultCodes | A JSON object that contains the return and status codes of the service. |
result | A JSON object that contains the generated registration activation data. |
Example
{
"resultCodes":
{
"returnCodeEnum": "RET_SUCCESS",
"statusCodeEnum": "STAT_SUCCESS",
"returnCode": 0,
"statusCode": 0
},
"result":
{
"instanceActivationMessage": "011665337766495347390016546230343861..."
}
}