getPreparedSignatureRequest (Service)

API version: 2

Availability: DIGIPASS Gateway 5.0 and later

Authentication: Basic HTTP authentication using the front-end API key.

The getPreparedSignatureRequest service retrieves a prepared signature request for transaction data signing. The respective signature request is identified by a request key previously received via push notification.

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 the STAT_NOT_FOUND status code.

Depending on the user’s choice the mobile application can either complete the signature request (see authSignature (service)) or cancel it (see cancelAuthSignatureRequest (service)).

URL

https://dpgateway_host:dpgateway_port/rest/v2/signature/push /getPreparedSignatureRequest

Request

Parameter names are case-sensitive.

Example

{
  "requestKey": "8408980524",
  "serialNumber": "VDS1000120-1"
}

Response

Example

{
  "resultCodes":
    {
      "returnCodeEnum": "RET_SUCCESS",
      "statusCodeEnum": "STAT_SUCCESS",
      "returnCode": 0,
      "statusCode": 0
    },
  "result":
    {
      "requestMessage": "00C1C3E40F42B8B36D836BE8A3CC1168…"
    }
}