✍️eSign Events

Webhook events for Esign service providers.

Overview

The following Esign providers support webhook notifications:

• Signaturit

• Universign

Signaturit Events

Events

document_signed

Document has been signed by all signatories

Payload Example:

{
  "event": "document_signed",
  "timestamp": "2026-02-13T12:30:00Z",
  "dispatchId": "disp_abc123",
  "provider": "signaturit",
  "service": "esign",
  "data": {
    "documentId": "doc_xyz789",
    "status": "completed",
    "signers": [
      {
        "email": "[email protected]",
        "status": "signed",
        "signedAt": "2026-02-13T12:25:00Z"
      }
    ]
  }
}

document_declined

Document was declined by a signatory

Payload Example:

{
  "event": "document_declined",
  "timestamp": "2026-02-13T12:30:00Z",
  "dispatchId": "disp_abc123",
  "provider": "signaturit",
  "service": "esign",
  "data": {
    "documentId": "doc_xyz789",
    "status": "completed",
    "signers": [
      {
        "email": "[email protected]",
        "status": "signed",
        "signedAt": "2026-02-13T12:25:00Z"
      }
    ]
  }
}

document_expired

Document signing deadline expired

Payload Example:

{
  "event": "document_expired",
  "timestamp": "2026-02-13T12:30:00Z",
  "dispatchId": "disp_abc123",
  "provider": "signaturit",
  "service": "esign",
  "data": {
    "documentId": "doc_xyz789",
    "status": "completed",
    "signers": [
      {
        "email": "[email protected]",
        "status": "signed",
        "signedAt": "2026-02-13T12:25:00Z"
      }
    ]
  }
}

document_canceled

Document was canceled

Payload Example:

{
  "event": "document_canceled",
  "timestamp": "2026-02-13T12:30:00Z",
  "dispatchId": "disp_abc123",
  "provider": "signaturit",
  "service": "esign",
  "data": {
    "documentId": "doc_xyz789",
    "status": "completed",
    "signers": [
      {
        "email": "[email protected]",
        "status": "signed",
        "signedAt": "2026-02-13T12:25:00Z"
      }
    ]
  }
}

Webhook URL

Configure this URL in Signaturit dashboard:

POST https://api.docs-dispatcher.io/api/webhooks/esign/providers/signaturit/endpoint.json

Handler Example (Node.js)

app.post('/webhooks/esign/signaturit', async (req, res) => {
  const { event, data, dispatchId } = req.body;

  console.log(`Received signaturit event: ${event}`);

  switch (event) {
    case 'document_signed':
      // Handle document has been signed by all signatories
      await handleDocumentsigned(data);
      break;

    case 'document_declined':
      // Handle document was declined by a signatory
      await handleDocumentdeclined(data);
      break;

    case 'document_expired':
      // Handle document signing deadline expired
      await handleDocumentexpired(data);
      break;

    case 'document_canceled':
      // Handle document was canceled
      await handleDocumentcanceled(data);
      break;

    default:
      console.warn(`Unknown event type: ${event}`);
  }

  // Always return 200 to acknowledge receipt
  res.status(200).json({ received: true });
});

Universign Events

Events

transaction_completed

Signature transaction completed successfully

Payload Example:

{
  "event": "transaction_completed",
  "timestamp": "2026-02-13T12:30:00Z",
  "dispatchId": "disp_abc123",
  "provider": "universign",
  "service": "esign",
  "data": {
    "documentId": "doc_xyz789",
    "status": "completed",
    "signers": [
      {
        "email": "[email protected]",
        "status": "signed",
        "signedAt": "2026-02-13T12:25:00Z"
      }
    ]
  }
}

transaction_failed

Signature transaction failed

Payload Example:

{
  "event": "transaction_failed",
  "timestamp": "2026-02-13T12:30:00Z",
  "dispatchId": "disp_abc123",
  "provider": "universign",
  "service": "esign",
  "data": {
    "documentId": "doc_xyz789",
    "status": "completed",
    "signers": [
      {
        "email": "[email protected]",
        "status": "signed",
        "signedAt": "2026-02-13T12:25:00Z"
      }
    ]
  }
}

transaction_canceled

Signature transaction was canceled

Payload Example:

{
  "event": "transaction_canceled",
  "timestamp": "2026-02-13T12:30:00Z",
  "dispatchId": "disp_abc123",
  "provider": "universign",
  "service": "esign",
  "data": {
    "documentId": "doc_xyz789",
    "status": "completed",
    "signers": [
      {
        "email": "[email protected]",
        "status": "signed",
        "signedAt": "2026-02-13T12:25:00Z"
      }
    ]
  }
}

signer_signed

Individual signer completed their signature

Payload Example:

{
  "event": "signer_signed",
  "timestamp": "2026-02-13T12:30:00Z",
  "dispatchId": "disp_abc123",
  "provider": "universign",
  "service": "esign",
  "data": {
    "documentId": "doc_xyz789",
    "status": "completed",
    "signers": [
      {
        "email": "[email protected]",
        "status": "signed",
        "signedAt": "2026-02-13T12:25:00Z"
      }
    ]
  }
}

Webhook URL

Configure this URL in Universign dashboard:

POST https://api.docs-dispatcher.io/api/webhooks/esign/providers/universign/endpoint.json

Handler Example (Node.js)

app.post('/webhooks/esign/universign', async (req, res) => {
  const { event, data, dispatchId } = req.body;

  console.log(`Received universign event: ${event}`);

  switch (event) {
    case 'transaction_completed':
      // Handle signature transaction completed successfully
      await handleTransactioncompleted(data);
      break;

    case 'transaction_failed':
      // Handle signature transaction failed
      await handleTransactionfailed(data);
      break;

    case 'transaction_canceled':
      // Handle signature transaction was canceled
      await handleTransactioncanceled(data);
      break;

    case 'signer_signed':
      // Handle individual signer completed their signature
      await handleSignersigned(data);
      break;

    default:
      console.warn(`Unknown event type: ${event}`);
  }

  // Always return 200 to acknowledge receipt
  res.status(200).json({ received: true });
});

Best Practices

1. Respond Quickly

Always return 200 OK within 5 seconds:

// ✅ Good - acknowledge immediately, process async
app.post('/webhook', async (req, res) => {
  res.status(200).json({ received: true });
  await processWebhookAsync(req.body); // Process in background
});

// ❌ Bad - slow processing blocks response
app.post('/webhook', async (req, res) => {
  await longRunningProcess(req.body); // Takes 30+ seconds
  res.status(200).json({ received: true });
});

2. Verify Signatures

Always verify webhook signatures to prevent spoofing:

const signature = req.headers['x-webhook-signature'];
if (!verifySignature(req.body, signature, secret)) {
  return res.status(401).json({ error: 'Invalid signature' });
}

3. Handle Idempotency

Webhooks may be delivered multiple times - use idempotency:

const eventId = req.body.dispatchId + '_' + req.body.event;
if (await isProcessed(eventId)) {
  return res.status(200).json({ received: true, duplicate: true });
}
await markProcessed(eventId);

Next Steps

• Webhook Fundamentals

• Events Catalog

• Async Dispatch Recipe

• Signaturit Provider

• Universign Provider