Versenden Sie Ihre erste E-Signatur-Flow schnell mit Firma: Ein Entwickler-Schnellstart

Sind Sie Entwickler und haben bereits Ihr Firma.dev-Konto? Perfekt. Diese Anleitung führt Sie vom „API-Schlüssel in der Hand“ zu einem Live- eingebetteten Signatur-Flow. Wir halten es schlank, konzentrieren uns auf Entscheidungen und verlinken Sie direkt zu funktionierenden Code-Snippets in der Dokumentation.

Suchen Sie nach dem nicht-technischen Leitfaden? Hier klicken.

Was Sie tun werden

1. Kundenisolierung mit Workspaces modellieren

2. Eine wiederverwendbare Vorlage erstellen

3. Eine Signaturanfrage senden

4. Das Signatur-Erlebnis einbetten oder weiterleiten

5. Alles mit Webhooks verfolgen

Die Preisgestaltung ist einfach. Es sind €0,049 pro Umschlag, testen Sie mit echten Dokumenten, kostenlos, damit Sie alles von Ende zu Ende aufbauen und testen können.

Voraussetzungen

Firmen- oder Workspace-API-Schlüssel aus Ihrem Dashboard

• Ein PDF, das Sie in eine Vorlage umwandeln können

• Ein Ort, an dem Servercode für die JWT-Generierung und Webhooks ausgeführt werden kann

Benötigen Sie eine Auffrischung zum Gesamtablauf? Siehe die vollständige Einrichtungsanleitung.

1) Einen Workspace für jeden Kunden erstellen

Workspaces bieten jedem Kunden einen privaten, partitionierten Bereich mit isolierten Vorlagen, Dokumenten und Nutzung. Dies ist der sauberste Weg, um eine SaaS-typische Trennung mehrerer Mandanten aufzubauen, ohne dass Daten zwischen Kunden preisgegeben werden.

Workspace erstellen
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Workspace erstellen
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Workspace erstellen
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Hilfreich: Workspace-Einstellungen wie E-Mail-Inhalte und Zeitzone gelten pro Workspace.

Leitfaden für Workspace-Einstellungen
https://docs.firma.dev/guides/workspace-settings

Leitfaden für Workspace-Einstellungen
https://docs.firma.dev/guides/workspace-settings

Leitfaden für Workspace-Einstellungen
https://docs.firma.dev/guides/workspace-settings

2) Eine wiederverwendbare Vorlage erstellen

Vorlagen enthalten das PDF sowie Rollen und Felder, sodass Sie dasselbe Dokument mehrfach an verschiedene Empfänger senden können.

Vorlage erstellen (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Vorlage erstellen (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Vorlage erstellen (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Option A: Benutzer Vorlagen in Ihrer App entwerfen lassen

Betten Sie den Vorlagen-Editor mit einem kurzlebigen JWT ein.

Einbettbarer Vorlagen-Editor (Leitfaden)
https://docs.firma.dev/guides/embeddable-template-editor

Einbettbarer Vorlagen-Editor (Leitfaden)
https://docs.firma.dev/guides/embeddable-template-editor

Einbettbarer Vorlagen-Editor (Leitfaden)
https://docs.firma.dev/guides/embeddable-template-editor

Generieren Sie das Token serverseitig.

JWT für Vorlageneinbettung generieren
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

JWT für Vorlageneinbettung generieren
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

JWT für Vorlageneinbettung generieren
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

3) Die Signaturanfrage erstellen

Verwandeln Sie Ihre Vorlage in eine Live-Transaktion. Sie können sie auf Wunsch auch aus einer reinen PDF-Datei erstellen. Die Referenz deckt Empfänger, Felder, Erinnerungen und Validierungsregeln ab.

Signaturanfrage erstellen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Signaturanfrage erstellen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Signaturanfrage erstellen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Optional: Geschäftskunden Details ausfüllen und über Ihre UI senden lassen

Betten Sie den Signaturanfrage-Editor mit einem 7-Tage-JWT ein.

Einbettbarer Signaturanfrage-Editor (Leitfaden)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Einbettbarer Signaturanfrage-Editor (Leitfaden)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Einbettbarer Signaturanfrage-Editor (Leitfaden)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Generieren Sie das JWT serverseitig.

JWT für Signaturanfrage-Editor generieren
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

JWT für Signaturanfrage-Editor generieren
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

JWT für Signaturanfrage-Editor generieren
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

4) Die Signaturanfrage senden

Wenn Sie bereit sind, lösen Sie den Versand aus.

Signaturanfrage senden
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

Signaturanfrage senden
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

Signaturanfrage senden
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

5) Signatur in Ihrem Produkt oder per Weiterleitung bereitstellen

Eingebettete Signatur

Jeder Empfänger unterschreibt unter einer eindeutigen URL, die diesem Muster folgt:

https://app.firma.dev/signing/{signing_request_user_id}.

Einbettbare Signatur (Iframe-Muster und Tipps)
https://docs.firma.dev/guides/embeddable-signing

Einbettbare Signatur (Iframe-Muster und Tipps)
https://docs.firma.dev/guides/embeddable-signing

Einbettbare Signatur (Iframe-Muster und Tipps)
https://docs.firma.dev/guides/embeddable-signing

Sie rufen die signing_request_user_id über die API ab.

Signaturanfrage-Benutzer abrufen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Signaturanfrage-Benutzer abrufen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Signaturanfrage-Benutzer abrufen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Weiterleitungs-Signatur

Alternativ können Sie Empfänger zur gehosteten Signaturoberfläche leiten. Weitere Details finden Sie in der obigen Anleitung.

6) Alles mit Webhooks verfolgen

Lauschen Sie auf Ereignisse wie erstellt, gesendet, angesehen, signiert und abgeschlossen, um Ihr System in Echtzeit zu aktualisieren. Der Leitfaden enthält HMAC-Verifizierung, Rotation, Wiederholungsversuche und eine Produktions-Checkliste.

Webhooks-Leitfaden
https://docs.firma.dev/guides/webhooks

Webhooks-Leitfaden
https://docs.firma.dev/guides/webhooks

Webhooks-Leitfaden
https://docs.firma.dev/guides/webhooks

Webhook erstellen (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Webhook erstellen (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Webhook erstellen (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Kurze Notizen zur Architektur

• JWTs. Generieren Sie diese serverseitig. Token für den Vorlagen-Editor sind kurzlebig; Token für den Signaturanfrage-Editor laufen nach 7 Tagen ab.

• Workspaces für SaaS. Halten Sie Kunden vollständig partitioniert. Ihre Operatoren arbeiten weiterhin mit einer einzigen API.

• Preise und Einführung. Beginnen Sie mit den enthaltenen kostenlosen Umschlägen und gehen Sie dann live. Keine Mindestmengen. €0,049 pro Umschlag.

Was kommt als Nächstes?

1. Verbinden Sie Ihren ersten Workspace

2. Fügen Sie eine Vorlage hinzu

3. Senden Sie Ihre erste Anfrage

4. Wählen Sie Einbettung oder Weiterleitung

5. Richten Sie Webhooks ein

👉 API-Schlüssel holen - keine Kreditkarte erforderlich.