Availability: OneSpan Authentication Server 3.17 and later
Scenario: Signature
Support: full-sdk auth-sdk
The getPreparedSignatureRequest command retrieves a prepared signature request for transaction data signing. The respective signature request is identified by a request key previously received via push notification after a respective authSignatureRequest call (see authSignatureRequest (Command)).
This command is typically initiated by a mobile application. Only one application is allowed to retrieve the signature request. The request key is consumed by the first application retrieving the signature transaction message, subsequent attempts to retrieve it will fail with status code STAT_NOT_FOUND.
Parameters
| Parameter name | Data type | Description |
|---|---|---|
| status | CommandStatusResponse | 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. |
| result | GetPreparedSignatureRequestResult | Optional. The result of the command, i.e. the signature request as a secure channel message (see GetPreparedSignatureRequestResult (Data type)). |
GetPreparedSignatureRequestResult (Data type)
| Parameter name | Data type | Description |
|---|---|---|
| requestMessage | hexBinary | Required. The signature request as a secure channel message. |
Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header/>
<soapenv:Body>
<sig:getPreparedSignatureRequest xmlns:prov="http://www.vasco.com/IdentikeyServer/IdentikeyTypes/Signature">
<componentType>Push Notification Client</componentType>
<serialNumber>12345678</serialNumber>
<requestKey>abcdef010203</requestKey>
</sig:getPreparedSignatureRequest>
</soapenv:Body>
</soapenv:Envelope>