3. Create Signer Process

Creating the Document Signature Process

The portal requests the creation of the PDF document batch signature process by sending the following message to the UAE PASS using the signature services API. This API call will create a signing process at UAE PASS end.

POST stg-id.uaepass.ae/trustedx-resources/esignsp/v2/signer_processes

HTTP/1.1

Headers

Name	Type	Description
Authorization*	string	Bearer <token>
Cache-Control*	string	no-cache
Postman-Token*	string	0cb4e517-8db9-473c-7b14-0ca2555bc199
Content-Type*	string	application/json

Response

201 If the request is successfully processed, UAE PASS creates the signature process for the document and responds to the document signature portal with the following HTTP message. Location: https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/signer_processes/sp_c4eed0a1f478f72454803695d53c4c52 Content-Type: application/json

{
    "process_type": "urn:safelayer:eidas:processes:document:sign:esigp",
    "id": "hrcmc4pr78dt4s35jlbi4nmdrler4nn2",
    "self": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/signer_processes/hrcmc4pr78dt4s35jlbi4nmdrler4nn2",
    "tasks": {
        "pending": [
            {
                "type": "UserBrowserTask",
                "id": "dtvnbg6pbmaec4a35tlpnt1krs27hve1",
                "url": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/ui?signerProcessId=hrcmc4pr78dt4s35jlbi4nmdrler4nn2"
            }
        ]
    },
    "documents": [
        {
            "id": "c7mrogv8sqersqfj4sj7q21ucs1d3t4r",
            "url": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/c7mrogv8sqersqfj4sj7q21ucs1d3t4r",
            "content": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/c7mrogv8sqersqfj4sj7q21ucs1d3t4r/content"
        },
        {
            "id": "afa9gmord6dh6vhlvp1s533fs5fn8tui",
            "url": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/afa9gmord6dh6vhlvp1s533fs5fn8tui",
            "content": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/afa9gmord6dh6vhlvp1s533fs5fn8tui/content"
        }
    ]
}

Request Body

{
              "process_type": "urn:safelayer:eidas:processes:document:sign:esigp",
              "labels": [
                             [
                                           "digitalid",
                                           "server",
                                           "qualified"
                             ]
              ],
"documents": [
        {
            "id":"ieedah0mrjshgpblmt418l2m4rh8tlrd"
        },
        {
            "id":"g6do7ak05v3mod6i5sti3v33kdf0al9a"
        }
        ]
        ,

              "ui_locales": [
                             "en_US"
              ],
              "finish_callback_url": "http://localhost:8080/test",
              "views": {
                             "document_agreement": {
                                           "skip_server_id": "true"
                             }
              },
              "timestamp": {
                             "provider_id": "urn:uae:tws:generation:policy:digitalid"
              }
}

UAEPASS communicates with the signature portal, that successfully creates the signature process and that must redirects the user's browser to https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/ui?signerProcessId=sp_c4eed0a1f478f72454803695d53c4c5 (tasks.pending.url) for this process to continue.

It also communicates to the signature portal that obtain the signed document it must access https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/dc_9ee0990055818516249f28558e1b256b/content (i.e., the URL resulting from concatenating /content to the URL specified in documents[0].If signing the same document twice, make sure that unique value is passed for the name parameter in process type of request body as below: