DSS Integration Steps

Preparation

  1. Obtain Credentials
    Contact Sales to obtain:
    - Sandbox Roaming Certificate Credentials: pCode, userId, orgId, pin
    - DSS Credentials: API Key and fileServerId
  2. Prepare the PDF Document
    - Generate the PDF using any PDF library for integration
    - Or use an existing PDF from your document server
  3. (Optional) Define Signature Placement
    - Specify the page number and X/Y coordinates for the digital signature
    - Prepare a custom e-signature image if required
  4. (Optional) Embed a QR Code
    - Enables verification via the eValidator app (Play Store & App Store)
    - Users can verify the printed version by scanning and retrieving the original PDF

Using the DSS API

  1. Generate Client Code
    Use the DSS OpenAPI (Swagger) specification to generate client code. The Swagger file is available for download.
  2. Upload Files
    Upload your PDF and optional signature image using the DSS API. Call files/upload.
  3. Verify Roaming Certificate
    Call verifyRoamingCert to confirm certificate existence.
  4. Authenticate with Roaming Credentials
    Call verifyRoamingPin to authenticate.
  5. Sign the Document
    Call signPdf to apply the digital signature.
  6. Download the Signed Document
    Retrieve the signed PDF via the appropriate DSS API endpoint. Call /files/download/{fileServerId}/{filename}