updateDevicePNID (Command)

  • Published on Jul 7, 2025
  • 1 minute(s) read
Prev Next

The OneSpan Mobile Authenticator app must update OneSpan Authentication Server data when the DIGIPASS Push Notification Identifier (PNID) of the device changes. The updateDevicePNID command is used to update the PNID associated with a specific device.

Parameters

  Table: updateDevicePNID input parameters (SOAP provisioning)
Parameter nameData typeDescription
componentTypeStringRequired. Specifies the client component to serve the request.
userUserInputRequired. The user input information (see UserInput (Data type)). This specifies the user to be authenticated for the provisioning operation.
serialNumberStringRequired. The serial number of the authenticator associated with the device PNID.
devicePNIDHexadecimal StringRequired. The PNID of a mobile device encoded as encrypted secure channel message. Maximum 1070+1 characters.
  Table: updateDevicePNID output parameters (SOAP provisioning) 
Parameter nameData typeDescription
statusCommandStatusResponse

Required. The error stack, if applicable, which indicates that the command has not completed successfully. This also includes the result and status codes returned by the command.

UserInput (Data type)

  Table:  UserInput (Data type)
Element nameData typeDescription
userIDStringThe user ID.
domainStringOptional. The user domain.

Example

 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Header/>
  <soapenv:Body>
    <prov:updateDevicePNID xmlns:prov="http://www.vasco.com/IdentikeyServer/IdentikeyTypes/Provisioning">
      <componentType>Push Notification Client</componentType>
      <user>
        <userID>user1</userID>
        <domain>Master</domain>
      </user>
      <serialNumber>12345678</serialNumber>
      <devicePNID>ABCDEF010203</devicePNID>
    </prov:updateDevicePNID>
  </soapenv:Body>
</soapenv:Envelope>