Wie man eine Document Signatur-API in sein SaaS-Produkt als White-Label integriert

Suchen Sie die vollständige Aufschlüsselung? Dieser Beitrag behandelt die wichtigsten Konzepte und Entscheidungen. Eine umfassende Anleitung zu allen White-Labeling-Funktionen, einschließlich Logos, Farbanpassung, benutzerdefinierten E-Mail-Vorlagen, Absenderadressen und Codebeispielen, finden Sie unter The Complete Guide to White-Label E-Signatures for SaaS.

Wenn Sie eine API für Dokumentenunterschriften in Ihr Produkt integrieren, sollten Ihre Kunden nicht das Gefühl haben, die Software eines Drittanbieters zu nutzen. Das Unterzeichnungserlebnis sollte optisch und funktional Ihrem Produkt entsprechen, nicht einem Drittanbieter-Tool.

White-Labeling macht das möglich. Doch viele Entwickler denken, White-Labeling bedeute nur, ein Logo auf etwas zu klatschen. In der Praxis ist es nuancierter. Eine vollständig gebrandete Integration einer API für digitale Signaturen umfasst visuelles Branding, E-Mail-Anpassung, Benachrichtigungssteuerung und eingebettete Schnittstellen – und Sie benötigen nicht immer alle davon.

Dieser Leitfaden erklärt, was die einzelnen Ebenen bewirken, wann Sie sie einsetzen sollten und wie Sie eine White-Label-PDF-Signatur-API implementieren, die zu Ihrem Produkt passt.

Was White-Labeling für E-Signaturen tatsächlich bedeutet

Wenn ein Kunde ein Dokument über Ihre App unterzeichnet, weisen mehrere Berührungspunkte ein Branding auf:

• Die Unterzeichnungsoberfläche selbst (Logo, Farben, Layout)

• Die E-Mail, die den Kunden darüber informiert, dass ein Dokument zur Unterzeichnung bereitsteht

• Die Absenderadresse und die E-Mail-Vorlage

• Benachrichtigungen über den Abschluss und Erinnerungen

• Jegliche rechtlichen Bedingungen oder Zustimmungsschritte

Standardmäßig versehen die meisten Signatur-APIs all diese Punkte mit ihrem eigenen Namen. Das White-Labeling ermöglicht es Ihnen, dieses Branding durch Ihr eigenes zu ersetzen oder es vollständig zu entfernen.

Das Ziel ist einfach: Ihre Kunden interagieren während des gesamten Signatur-Workflows mit Ihrer Marke. Sie sehen den dahinterstehenden API-Anbieter nie.

Die vier Ebenen des White-Labelings

Ebene 1: Visuelles Branding

Der unmittelbarste Effekt. Laden Sie Ihr Logo hoch, legen Sie Ihre Farbpalette fest und blenden Sie das Branding des API-Anbieters vollständig aus dem Unterzeichnungserlebnis aus.

Mit Firma.dev steuern Sie sechs Farbeinstellungen (Hauptakzent, Vordergrundtext, Hintergrund, Kartenfarbe und Rahmenfarbe) und können Logos sowohl auf Unternehmens- als auch auf Workspace-Ebene hochladen. Für mandantenfähige SaaS-Produkte bedeutet dies, dass jeder Ihrer Kunden seine eigene visuelle Identität im Signaturfluss haben kann.

Aktivieren Sie show_custom_branding_only, und die Unterzeichnungsoberfläche sieht aus, als wäre sie von Ihrem Team entwickelt worden. Keine Logos von Drittanbietern, keine fremden Farbschemata.

Die Implementierung dieser Ebene dauert nur wenige Minuten und erzielt die größte sichtbare Wirkung. Beginnen Sie hier, auch wenn Sie die anderen Ebenen erst später hinzufügen möchten.

Ebene 2: Eigene E-Mail-Domains und Vorlagen

Anstatt Signaturanfragen von noreply@signatureprovider.com zu senden, kommen E-Mails von Ihrer eigenen Domain, wie documents@yourcompany.com. Sie steuern auch den lokalen Teil der Absenderadresse (den Teil vor dem @), sodass Sie noreply, signing, contracts oder was auch immer zu Ihrem Produkt passt, verwenden können.

Neben dem Absender können Sie auch die E-Mail-Vorlagen selbst anpassen. Firma.dev unterstützt benutzerdefinierte HTML-Vorlagen für 11 E-Mail-Typen (Signatureinladungen, Abschlüsse, Erinnerungen, Abläufe und mehr) mit dynamischen Platzhaltern für Unterzeichnernamen, Signaturlinks, Firmenlogos und Teamdetails. Legen Sie Vorlagen auf Unternehmensebene für eine einheitliche Gestaltung fest und überschreiben Sie diese bei Bedarf für einzelne Workspaces.

Für mandantenfähige SaaS-Produkte bedeuten E-Mail-Domains auf Workspace-Ebene, dass jeder Ihrer Kunden von seiner eigenen Domain aus senden kann. Bei einer Immobilienverwaltungsplattform könnten Signatur-E-Mails für jede Immobilie von leases@buildingname.com gesendet werden.

Wenn Sie nach einer schnellen Implementierung suchen, finden Sie unter How to White-Label Your E-Signature Emails and Signing Links eine Schritt-für-Schritt-Anleitung.

Ebene 3: Benachrichtigungssteuerung

Gebrandete E-Mails und benutzerdefinierte Vorlagen sind gut. Die volle Kontrolle über Benachrichtigungen ist besser.

Die meisten APIs für digitale Signaturen senden automatisierte E-Mails für Signaturanfragen, Abschlussbestätigungen, Ablaufwarnungen und Stornierungshinweise. Eine White-Label-Konfiguration ermöglicht es Ihnen, alle oder einzelne dieser Benachrichtigungen pro Signaturanfrage zu deaktivieren.

Warum sollten Sie diese deaktivieren wollen? Weil Sie möglicherweise:

• Signaturlinks über Ihre eigene E-Mail-Infrastruktur senden möchten

• Benachrichtigungen in bestehende Kommunikationsabläufe mit Kunden integrieren möchten

• Den Zeitpunkt für Erinnerungen und Follow-ups selbst steuern möchten

• E-Mails basierend auf Ihrer eigenen Geschäftslogik auslösen möchten

Wenn Sie die E-Mails der API deaktivieren, rufen Sie die Signatur-URLs direkt von der API ab und verteilen sie, wie Sie möchten. Dies ist besonders nützlich, wenn Sie bereits über eine Transaktions-E-Mail-Infrastruktur (SendGrid, Postmark, Customer.io) verfügen und die Signaturbenachrichtigungen über dasselbe System laufen lassen möchten.

Ebene 4: Eingebettete Unterzeichnungserlebnisse

Dies ist die vollständige White-Label-Lösung. Anstatt Benutzer auf eine Signaturseite eines Drittanbieters weiterzuleiten, betten Sie die Unterzeichnungsoberfläche direkt in Ihre Anwendung ein.

Mit dem eingebetteten Signieren findet der gesamte Workflow innerhalb Ihres Produkts statt. Die Benutzer verlassen Ihre Domain nie. Sie sehen Ihre Kopfzeile, Ihre Navigation, Ihr Design. Die Signaturoberfläche erscheint als nahtloser Teil Ihrer App, dargestellt mit Ihrem Logo und Ihren Farben.

Die meisten PDF-Signatur-APIs bieten einbettbare Komponenten für:

• Unterzeichnen: Der eigentliche Workflow zur Dokumentenunterzeichnung

• Vorlagenbearbeitung: Ermöglicht es Benutzern, Signaturfelder und Platzhalter zu definieren

• Konfiguration von Signaturanfragen: Einrichten von Empfängern, Reihenfolge und Optionen

Eingebettete Erlebnisse nutzen in der Regel die JWT-Authentifizierung (JSON Web Token). Ihr Backend generiert ein kurzlebiges Token, und das Frontend lädt die eingebettete Komponente mit diesem Token. Es werden keine API-Schlüssel für den Client offengelegt.

Für SaaS-Produkte, bei denen die Dokumentenunterzeichnung eine Kernfunktion ist, lohnt sich der Implementierungsaufwand für das eingebettete Signieren meistens. Ihr Produkt fühlt sich konsistenter an und Sie behalten die volle Kontrolle über das Benutzererlebnis.

Den richtigen Ansatz wählen

Nicht jede Integration erfordert ein vollständiges White-Labeling. So können Sie sich entscheiden:

Logo, Farben und gebrandete E-Mails eignen sich gut, wenn das Signieren eine Nebenfunktion ist. Ihre Kunden erhalten ein professionelles, gebrandetes Erlebnis ohne großen Entwicklungsaufwand. Die Implementierung dauert einige Stunden und besteht hauptsächlich aus der DNS-Konfiguration und einigen API-Aufrufen für das visuelle Branding.

Obiges + benutzerdefinierte E-Mail-Vorlagen eignet sich für Produkte, bei denen Sie eine gebrandete Kommunikation wünschen, ohne Ihre E-Mail-Infrastruktur zu ersetzen. Sie passen den Inhalt und das HTML der Signatur-E-Mails an, während Firma.dev den Versand übernimmt. Dies bedeutet etwa ein bis zwei Stunden zusätzlichen Aufwand für die Vorlagengestaltung.

Obiges + Benachrichtigungssteuerung ist der richtige Schritt, wenn Sie die Kommunikationsebene vollständig selbst kontrollieren möchten. Möglicherweise haben Sie spezielle Compliance-Anforderungen bezüglich E-Mails oder möchten, dass Signaturbenachrichtigungen über Ihr bestehendes Transaktionssystem laufen. Dies bedeutet etwa ein bis zwei Tage Integrationsarbeit.

Das vollständig eingebettete Erlebnis ist die richtige Wahl, wenn das Signieren eine zentrale Rolle in Ihrem Produkt spielt. HR-Plattformen, Vertragsmanagement-Tools, Immobiliensoftware, Onboarding-Systeme im Gesundheitswesen. Wenn Ihre Kunden viel Zeit in Signatur-Workflows verbringen, zahlt sich die Einbettung dieses Erlebnisses aus. Rechnen Sie mit einigen Tagen bis zu einer Woche Integrationsaufwand, je nachdem, wie viele Komponenten Sie einbetten.

Überlegungen zur Implementierung

Einige Dinge, die Sie vor dem Start bedenken sollten:

1. Workspaces und Mandantenfähigkeit. Wenn Sie ein mandantenfähiges SaaS-Produkt entwickeln, suchen Sie nach einer API für Dokumentenunterstutzung, die Kunden-Workspaces unterstützt. Jeder Ihrer Kunden erhält eine isolierte Umgebung mit eigenen Vorlagen, einer eigenen Signaturhistorie, eigenem Branding und (optional) einer eigenen E-Mail-Domain. Dies hält die Daten sauber getrennt, ohne dass Sie die Mandantenisolierung selbst entwickeln müssen.

2. Die Einstellungshierarchie. Branding-Einstellungen in Firma.dev sind kaskadierend aufgebaut: Workspaces überschreiben das Unternehmen, das Unternehmen überschreibt die Standardeinstellungen. Das bedeutet, dass Sie das unternehmensweite Branding einmal festlegen und nur bei Bedarf Abweichungen auf Workspace-Ebene konfigurieren. Wenn Sie einen Workspace-Wert auf null setzen, übernimmt er die Einstellungen der Unternehmensebene.

3. Sicherheit. Generieren Sie JWT-Token auf Ihrem Backend, niemals im clientseitigen Code. Halten Sie die Gültigkeitsdauer der Token kurz (1-4 Stunden sind üblich). Überprüfen Sie die Herkunft von Iframe-Nachrichten, wenn Sie Ereignisse von eingebetteten Komponenten verarbeiten.

4. Compliance. White-Labeling ändert nichts an der rechtlichen Gültigkeit von Signaturen. Eine gut konzipierte API für digitale Signaturen gewährleistet die Einhaltung von ESIGN, UETA und eIDAS unabhängig vom Branding. Stellen Sie sicher, dass Ihr Anbieter die für Ihre Kunden relevanten regulatorischen Rahmenbedingungen unterstützt.

5. Kosten. Enterprise-Signaturplattformen verlangen oft hohe Gebühren für White-Labeling-Funktionen. Einige Anbieter bieten White-Labeling in allen Tarifen an. Firma.dev enthält alle White-Labeling-Funktionen in einem Pay-as-you-go-Modell für 0,029 € pro Umschlag (ca. 3 ¢ USD), ohne Verträge oder Mindestumsätze.

Erste Schritte

Wenn Sie APIs für Dokumentenunterstutzung für eine White-Label-Integration evaluieren, skizzieren Sie zunächst, welche Berührungspunkte für Ihre Kunden am wichtigsten sind. Legen sie Wert auf das E-Mail-Branding? Müssen sie den Signaturfluss einbetten? Die Antworten werden den Umfang Ihrer Implementierung bestimmen.

Für eine detaillierte technische Anleitung behandelt der Firma.dev White Labeling Guide benutzerdefinierte E-Mail-Domains, Benachrichtigungseinstellungen und eingebettete Komponenten mit Codebeispielen.

Bereit loszulegen? Holen Sie sich Ihren API-Schlüssel und starten Sie die Integration in wenigen Stunden, nicht Wochen.