JavaScript Integration

Browser integration for mobile and desktop using the same securesign:// deep link.

There is no public JavaScript SDK package. Integrate directly with the SecureSign deep link — the same securesign://sign handoff for mobile browsers and desktop browsers on Windows, Linux, and macOS.

Unified Deep Link

const params = new URLSearchParams({
  requestId: crypto.randomUUID(),
  hashBase64: sha256Base64,
  hashAlgo: 'SHA256',
  documentType: 'hash',
  callbackUrl: 'https://portal.example.gov.in/sign/callback',
  apiKey: 'ss_live_abc123xyz'
});
window.location.href = `securesign://sign?${params}`;

Mobile — Opens SecureSign Mobile App

On Android and iOS browsers, the deep link launches SecureSign Mobile App. See Mobile Browser Flow.

Desktop — Opens SecureSign Desktop Software

On Windows, Linux, and macOS desktop browsers, the same deep link launches SecureSign Desktop Software. No fetch() to localhost and no browser extension. See Desktop Browser Flow.

Detect platform if needed

Most portals use one Sign with DSC button with the same deep link on all platforms. Optionally branch on user agent only for install prompts or help text — not for a different signing protocol.

Parse Callback

Mobile App and Desktop Software both return the signed payload to your callbackUrl via ss_result (base64 JSON):

function parseSignCallback(ssResultBase64) {
  const payload = JSON.parse(atob(ssResultBase64));
  return {
    requestId: payload.requestId,
    success: payload.success,
    signatureBase64: payload.signatureBase64,
    error: payload.error
  };
}