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

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

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

Was Sie tun werden

1. Kundenisolation 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. Sie beträgt €0,049 pro Umschlag, das Testen mit echten Dokumenten ist kostenlos, sodass Sie alles von Ende zu Ende erstellen und testen können.

Voraussetzungen

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

• Eine PDF-Datei, die 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 des gesamten Ablaufs? Siehe den vollständigen Einrichtungsleitfaden.

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 mandantenfähige Trennung im SaaS-Stil aufzubauen, ohne dass Daten zwischen Kunden verloren gehen.

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-Kopie 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 die PDF sowie Rollen und Felder, sodass Sie dasselbe Dokument an viele 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 Editor für Signaturanfragen mit einem 7-Tage-JWT ein.

Einbettbarer Editor für Signaturanfragen (Leitfaden)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Einbettbarer Editor für Signaturanfragen (Leitfaden)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Einbettbarer Editor für Signaturanfragen (Leitfaden)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Generieren Sie das JWT serverseitig.

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

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

JWT für den Editor für Signaturanfragen 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 Sendevorgang 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 innerhalb Ihres Produkts oder per Weiterleitung bereitstellen

Eingebettete Signatur

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

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

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

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

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

Sie rufen die signing_request_user_id von der API ab.

Benutzer für Signaturanfragen abrufen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Benutzer für Signaturanfragen abrufen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Benutzer für Signaturanfragen abrufen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Weiterleitung zur Signatur

Alternativ können Sie Empfänger zur gehosteten Signaturoberfläche weiterleiten. Einzelheiten finden Sie im selben Leitfaden oben.

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 Checkliste für die Produktion.

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 Hinweise zur Architektur

• JWTs. Generieren Sie diese serverseitig. Token für den Vorlagen-Editor sind kurzlebig; Token für den Editor für Signaturanfragen 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.

Wie geht es weiter?

1. Richten Sie Ihren ersten Workspace ein

2. Fügen Sie eine Vorlage hinzu

3. Senden Sie Ihre erste Anfrage

4. Wählen Sie Einbettung oder Weiterleitung

5. Webhooks einrichten

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