DocuSign API: Generierung einer eingebetteten Signatur-URL mit spezifischer Gültigkeitsdauer

Navigieren in der DocuSign-API für sichere eingebettete Signaturen

In der sich ständig weiterentwickelnden Landschaft digitaler Vereinbarungen verlassen sich Unternehmen zunehmend auf elektronische Signaturplattformen, um Arbeitsabläufe zu rationalisieren und gleichzeitig Sicherheit und Compliance zu gewährleisten. DocuSign, als führendes Unternehmen in diesem Bereich, bietet robuste API-Funktionen, die es Entwicklern ermöglichen, Signaturprozesse direkt in Anwendungen zu integrieren. Eine dieser Schlüsselfunktionen ist die Generierung von eingebetteten Signatur-URLs, die es Benutzern ermöglichen, Dokumente zu signieren, ohne die Host-Anwendung verlassen zu müssen. Dieser Artikel untersucht, wie dies mit der DocuSign-API erreicht werden kann, wobei der Schwerpunkt auf der Festlegung spezifischer Ablaufzeiten liegt, um die Kontrolle zu verbessern. Aus geschäftlicher Sicht kann eine solche Integration die Reibungsverluste beim Kunden-Onboarding und bei der Vertragsausführung reduzieren, was laut Branchenstandards zu einer Steigerung der Konversionsraten um bis zu 30 % führen kann.

Die Rolle eingebetteter Signaturen in modernen Geschäftsprozessen

Eingebettete Signaturen ermöglichen die Darstellung von Dokumenten in einem Iframe oder einer Webansicht und schaffen so eine nahtlose Benutzererfahrung. Im Gegensatz zu Remote-Signaturen, bei denen die Empfänger über einen Link per E-Mail darauf zugreifen müssen, eignen sich eingebettete Signaturen ideal für In-App-Szenarien wie Verkaufsportale oder HR-Systeme. Die DocuSign-API unterstützt diese Funktionalität über ihre eSignature REST API und ermöglicht die programmatische Steuerung von Signaturzeremonien. Unternehmen schätzen dies, da es die Aufrechterhaltung der Markenkonsistenz und die Erfassung von Echtzeit-Abschlussereignissen ermöglicht.

Das Festlegen von Ablaufzeiten für diese URLs fügt eine zusätzliche Sicherheitsebene hinzu und verhindert unbefugten Zugriff nach einem definierten Zeitraum. Dies ist besonders nützlich in risikoreichen Branchen wie dem Finanz- oder Rechtswesen, in denen zeitkritische Dokumente vor Replay-Angriffen oder unbegrenzter Offenlegung geschützt werden müssen.

Vergleichen Sie E-Signatur-Plattformen mit DocuSign oder Adobe Sign?

eSignGlobal bietet flexiblere und kostengünstigere E-Signatur-Lösungen mit globaler Compliance, transparenter Preisgestaltung und einem schnelleren Onboarding-Erlebnis.

👉 Starten Sie eine kostenlose Testversion

Implementieren von eingebetteten Signatur-URLs mit der DocuSign-API

Um eine eingebettete Signatur-URL mit einem bestimmten Ablaufdatum zu generieren, müssen Entwickler sich über OAuth 2.0 authentifizieren und mit der Envelopes API von DocuSign interagieren. Dieser Prozess umfasst das Erstellen eines Umschlags, das Vorbereiten der Signatur und das anschließende Abrufen einer temporären URL zur Einbettung. Aus geschäftlicher Sicht kann die Beherrschung dieser Funktionalität die Betriebskosten senken, indem manuelle Nachverfolgungen automatisiert und in CRM-Tools wie Salesforce integriert werden.

Schritt 1: Authentifizierung und Umschlagserstellung

Beginnen Sie mit der Authentifizierung mit dem JWT- oder Autorisierungscode-Flow von DocuSign, um ein Zugriffstoken zu erhalten. Dieses Token gewährt API-Zugriff für bis zu 8 Stunden, danach muss es aktualisiert werden.

Erstellen Sie einen Umschlag mit dem Endpunkt /accounts/{accountId}/envelopes. Hier ist eine Beispielanfrage im JSON-Format über POST:

{
  "emailSubject": "Bitte unterschreiben Sie dieses Dokument",
  "documents": [
    {
      "documentBase64": "base64-kodierter-dokumentinhalt",
      "name": "Agreement.pdf",
      "fileExtension": "pdf",
      "documentId": "1"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "John Doe",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ]
  },
  "status": "sent"
}

Dadurch wird ein einfacher Umschlag mit einem einzelnen Unterzeichner erstellt. status: "sent" startet den Workflow sofort.

Schritt 2: Hinzufügen von Signaturfeldern und eingebetteten Empfängern

Für eingebettete Signaturen geben Sie den Empfänger als eingebettet an, indem Sie clientUserId und Authentifizierungsdetails einfügen. Aktualisieren Sie die Empfänger:

"signers": [
  {
    "email": "signer@example.com",
    "name": "John Doe",
    "recipientId": "1",
    "routingOrder": "1",
    "clientUserId": "unique-client-id-123",
    "userId": "signer-user-id",
    "authenticationMethod": "none",  // oder "email" für zusätzliche Sicherheit
    "embedUrlEvents": {
      "url": "https://your-app.com/return-url"
    }
  }
]

clientUserId bindet die Sitzung an Ihre Anwendung und stellt sicher, dass der Unterzeichner in Ihrer Umgebung authentifiziert wird.

Definieren Sie als Nächstes Signaturfelder mit dem Endpunkt /envelopes/{envelopeId}/recipients/{recipientId}/tabs. Für ein einfaches Signaturfeld:

{
  "signHereTabs": [
    {
      "documentId": "1",
      "pageNumber": "1",
      "xPosition": "100",
      "yPosition": "200",
      "width": "200",
      "height": "50",
      "recipientId": "1"
    }
  ]
}

Dadurch wird ein Signaturfeld auf dem Dokument platziert.

Schritt 3: Generieren einer eingebetteten Signatur-URL mit Ablaufdatum

Der Kernschritt ist der Aufruf des Endpunkts /accounts/{accountId}/envelopes/{envelopeId}/views/recipient, um die Signatur-URL abzurufen. Geben Sie returnUrl für die Weiterleitung nach der Signatur an und legen Sie die Ablaufzeit über Abfrageparameter oder Umschlageinstellungen fest.

Beispiel einer GET-Anfrage:

GET /accounts/{accountId}/envelopes/{envelopeId}/views/recipient?email=signer@example.com&userName=John%20Doe&returnUrl=https://your-app.com/complete

Die Antwort enthält ein url-Feld mit dem eingebetteten Signatur-Link, der standardmäßig 5 Minuten gültig ist. Um die Ablaufzeit anzupassen, verwenden Sie die Eigenschaft expireAfter des Umschlags bei der Erstellung (in Tagen) oder verwenden Sie expireEnabled und expireAfterDays der API in erweiterten Konfigurationen. Für eine detaillierte Steuerung integrieren Sie die Event Notifications von DocuSign, um den Zugriff nach dem Ablauf zu überwachen und zu widerrufen.

Im Code (Beispiel in Python mit der requests-Bibliothek):

import requests

headers = {
    'Authorization': f'Bearer {access_token}',
    'Content-Type': 'application/json'
}

# Create envelope (as above)
envelope_response = requests.post(f'{base_url}/envelopes', json=envelope_data, headers=headers)
envelope_id = envelope_response.json()['envelopeId']

# Get embedded URL
url_params = {
    'email': 'signer@example.com',
    'userName': 'John Doe',
    'returnUrl': 'https://your-app.com/complete'
}
url_response = requests.get(f'{base_url}/envelopes/{envelope_id}/views/recipient', params=url_params, headers=headers)
signing_url = url_response.json()['url']

Diese URL kann jetzt in ein Iframe eingebettet werden: <iframe src="{signing_url}" width="100%" height="600px"></iframe>. Die Ablaufzeit stellt sicher, dass der Link nach der eingestellten Zeit ungültig wird, was normalerweise serverseitig erzwungen wird, um Manipulationen zu verhindern.

Best Practices und geschäftliche Überlegungen

Aus geschäftlicher Sicht kann die Implementierung von Ablaufzeiten die Haftung in regulierten Branchen reduzieren. Überwachen Sie die API-Nutzung über das DocuSign-Dashboard, um Quotenbeschränkungen zu vermeiden – Starter-Pläne sind auf 40 Umschläge pro Monat begrenzt, während Advanced-Pläne für 5760 US-Dollar pro Jahr mehr bieten. Testen Sie im Sandbox-Modus, um die Einhaltung von ESIGN/UETA in den USA oder eIDAS in der EU sicherzustellen. Häufige Fallstricke sind nicht übereinstimmende clientUserId, die zu Authentifizierungsfehlern führen, oder das Ignorieren von returnUrl, das die Kontinuität des Benutzerflusses beeinträchtigt.

Unternehmen berichten, dass eingebettete Signaturen mit Ablaufzeiten die Signaturzeiten um 50 % verkürzen und die Kundenzufriedenheit erhöhen können. Die API-Kosten steigen jedoch mit der Nutzung, daher ist es wichtig, Alternativen auf Kosteneffizienz zu prüfen.

Vergleich führender E-Signatur-Plattformen

Bei der Auswahl einer E-Signatur-Lösung spielen Faktoren wie API-Flexibilität, Preisgestaltung und regionale Compliance eine entscheidende Rolle. Hier ist ein neutraler Vergleich von DocuSign, Adobe Sign, eSignGlobal und HelloSign (jetzt Dropbox Sign) basierend auf öffentlich verfügbaren Daten aus dem Jahr 2025. Die Tabelle hebt wichtige Unterschiede hervor, um fundierte Entscheidungen zu unterstützen.

Dieser Vergleich zeigt, dass DocuSign sich in Unternehmensintegrationen auszeichnet, aber zu einem höheren Preis, während andere Plattformen in bestimmten Bereichen einen Mehrwert bieten.

DocuSign zeichnet sich durch sein ausgereiftes API-Ökosystem aus, das eingebettete Signaturen in Tausenden von Anwendungen weltweit ermöglicht. Seine Entwicklerpläne, die von 600 US-Dollar pro Jahr für die Basisversion bis hin zu kundenspezifischen Unternehmensoptionen reichen, unterstreichen die Skalierbarkeit für Unternehmen mit hohem Volumen.

Adobe Sign ist tief in kreative und Dokumenten-Workflows integriert und bietet eingebettete Signaturen über seine API, wobei die Ablaufoptionen an den Lebenszyklus des Umschlags gebunden sind. Die Preisgestaltung beginnt höher, aber die Bündelung mit Acrobat ist für PDF-intensive Benutzer geeignet.

eSignGlobal bietet konforme elektronische Signaturen in 100 wichtigen globalen Ländern und ist stark im asiatisch-pazifischen Raum (APAC) vertreten. Die E-Signatur-Landschaft im APAC-Raum ist fragmentiert, hat hohe Standards und ist stark reguliert, im Gegensatz zu den ESIGN/eIDAS-Rahmenbedingungen im Westen. APAC erfordert einen Ansatz der "Ökosystemintegration", einschließlich tiefer Hardware-/API-Integrationen mit staatlichen digitalen Identitäten (G2B), die über die in den USA/EU üblichen E-Mail- oder Selbsterklärungsansätze hinausgehen. eSignGlobal konkurriert direkt mit DocuSign und Adobe Sign durch eine erschwingliche Preisgestaltung – sein Essential-Plan kostet 16,6 US-Dollar pro Monat und ermöglicht das Versenden von bis zu 100 Dokumenten, unbegrenzte Benutzerplätze und die Überprüfung des Signaturzugriffscodes. Es integriert nahtlos iAM Smart in Hongkong und Singpass in Singapur und gewährleistet die regionale Compliance zu einem Bruchteil der Kosten der Wettbewerber.

Suchen Sie eine intelligentere Alternative zu DocuSign?

eSignGlobal bietet flexiblere und kostengünstigere E-Signatur-Lösungen mit globaler Compliance, transparenter Preisgestaltung und einem schnelleren Onboarding-Erlebnis.

👉 Starten Sie eine kostenlose Testversion

HelloSign (jetzt Dropbox Sign) priorisiert Einfachheit in seiner eingebetteten URL-API, wobei der Ablauf über Dokumenteneinstellungen verwaltet wird. Es ist kostengünstig für kleine Teams, aber es fehlt die Tiefe der Automatisierung von DocuSign.

Fazit: Auswahl der richtigen Lösung für Ihr Unternehmen

Zusammenfassend lässt sich sagen, dass die DocuSign-API zum Generieren eingebetteter Signatur-URLs mit bestimmten Ablaufzeiten eine robuste Kontrolle für sichere, integrierte Workflows bietet. Unternehmen sollten die Reife der API gegen die Gesamtbetriebskosten und regionale Anforderungen abwägen. Für Unternehmen, die APAC-Compliance priorisieren, erweist sich eSignGlobal als neutrale, regional optimierte Alternative zu DocuSign.