link

# Extra information and addons

Our signature API allows you to seamlessly integrate extra information into the response. See the available types below.

# PAdES file configuration

You can configure the look of the PAdES files that are generated after signing. Follow these steps:

  1. Open the developer dashboard (opens new window).
  2. Open your account and go to Settings > Signature PAdES settings.
  3. In the "Add data" field, select the information that must be included in the PAdES files.
  4. In the "Signature Details Page" field, select where you want the information to appear.

click-to-zoom PAdES file configuration

# When is the information ready?

There are multiple ways to get notified when the extra information is ready to be downloaded.

# Asynchronously

If you can support it, our recommendation is to subscribe to the ResourceCreatedEvent which will be triggered when the information is ready.

You can read more about webhooks and events in the Events documentation.

# Synchronously

If you need the information immediately after the signer has completed the signature, the easiest way to collect the information is to let the signer wait a few seconds while the requested information is processed.

First, log in to the Dashboard and complete the following steps:

  1. Find your account: Account -> View account.
  2. Find "Settings API" on the account menu.
  3. Find the signature settings and click Override.
  4. Choose the desired success action:
    • "Continue when resources complete" if you don't need to wait on the file packaging right now (faster).
    • "Continue when all is complete" if you need both the signed files and the resources to be ready before the signer proceeds to your success page.
  5. Optional: Set max poll time in seconds (defaults to 30), if the files are not ready within this time the signer is sent to the error page.

Redirect: The signer is not redirected until everyting is ready

Webmessaging: When you recieve the sign_success webmessage, all the requested resources/files are ready for retrieval

Webhook/ Events: Listen for the resource created event as a webhook or in the .Net events client.

# Error handling

If you are using the webmessage/iframe approach, you should handle errors accordingly. The relevant error codes are:

SA-1030: The resources/files were not ready within the specified max poll time

SA-1031: A generic error occured when checking the signature status

SA-1032: The extra information / resource could not be fetched because of an error specific to this resource

# Addons

Our signature API allows you to seamlessly integrate addons into the response. Please see the available types below.

# Addons for a signer

If you add a signer addon, the addon will be added for this specific signer

# Secure share

If this addon is enabled, a background task will upload the signed files to a secure share bucket when the document has received all the required signatures. The signer will then recieve an email/SMS with a link to our secure share service to be able to retrieve the files securely.

# Step 1 - Create document
POST /documents

Request sample

{
    ....
    "signers": [{
        ...
            "addons": {
                "types": ["secureShare"]                
            }

        ...        
    }]
    ....
}
# Step 2 - Retrieve document (after it is signed and the resources are ready)

This step is optional, as the secure share link is shared by email/SMS unless otherwise specified in the account settings mentioned above.

A link is added in the response. This link points to the secure share api bucket, where you can modify the share job if you want to.

GET /documents/{documentId}

Response sample

{
    ...
    "signers": [
        ...
        "links" : [{
            "href": "https://api.signicat.io/share/buckets/{id}",
            "rel": "secureShare",
            "contentType": "application/json",
      "resourceStatus": "Success"
        }]
        ...
    ]
    ...   
}
# Screenshots

click-to-zoom

Signer logs in and is able to download the files: click-to-zoom

Last updated: 17/12/2023 21:09 UTC