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

Bist du Entwickler und hast bereits ein Firma-Konto? Perfekt. Dieser Leitfaden führt dich von „API-Schlüssel in der Hand“ zu einem live eingebetteten Signatur-Workflow. Wir halten es schlank, konzentrieren uns auf Entscheidungen und verlinken dich direkt zu funktionierenden Snippets in der Dokumentation.

Suchst du den nicht-technischen Leitfaden? Klicke hier.

Was du tun wirst

1. Kundentrennung mit Workspaces modellieren

2. Eine wiederverwendbare Vorlage erstellen

3. Eine Signaturanforderung senden

4. Das Signaturerlebnis einbetten oder weiterleiten

5. Alles mit Webhooks verfolgen

Die Preisgestaltung ist einfach. Es sind €0.029 pro Umschlag, wobei die ersten 25 Umschläge kostenlos sind, damit du Ende-zu-Ende aufbauen und testen kannst.

Voraussetzungen

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

• Eine PDF, die du in eine Vorlage umwandeln kannst

• Ein Ort, um Servercode für die JWT-Erstellung und Webhooks auszuführen

Brauchst du eine Auffrischung zum Gesamtablauf? Sieh dir den vollständigen Einrichtungsleitfaden an.

1) Erstelle für jeden Kunden einen Workspace

Workspaces geben jedem Kunden einen privaten, partitionierten Bereich mit isolierten Vorlagen, Dokumenten und Nutzung. Das ist der sauberste Weg, SaaS-ähnliche Multi-Tenant-Trennung aufzubauen, ohne Daten zwischen Kunden durchsickern zu lassen.

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

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

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

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

Leitfaden zu Workspace-Einstellungen
https://docs.firma.dev/guides/workspace-settings

Leitfaden zu Workspace-Einstellungen
https://docs.firma.dev/guides/workspace-settings

Leitfaden zu Workspace-Einstellungen
https://docs.firma.dev/guides/workspace-settings

2) Erstelle eine wiederverwendbare Vorlage

Vorlagen enthalten die PDF sowie Rollen und Felder, sodass du dasselbe Dokument viele Male mit unterschiedlichen Empfängern senden kannst.

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: Lass Nutzer Vorlagen in deiner App gestalten

Bette 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

Generiere das Token serverseitig.

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

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

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

3) Erstelle die Signaturanforderung

Verwandle deine Vorlage in eine live Transaktion. Du kannst bei Bedarf auch aus einer rohen PDF erstellen. Die Referenz deckt Empfänger, Felder, Erinnerungen und Validierungsregeln ab.

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

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

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

Optional: Lass Geschäftsanwender Details ausfüllen und aus deiner UI senden

Bette den Editor für Signaturanforderungen mit einem 7-Tage-JWT ein.

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

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

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

Generiere das JWT serverseitig.

JWT für den Editor für Signaturanforderungen 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 Signaturanforderungen 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 Signaturanforderungen generieren
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

4) Sende die Signaturanforderung

Wenn du bereit bist, löse den Versand aus.

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

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

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

5) Stelle die Signatur in deinem Produkt oder per Weiterleitung bereit

Eingebettete Signatur

Jeder Empfänger signiert 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

Du rufst die signing_request_user_id über die API ab.

Empfänger der Signaturanforderung abrufen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Empfänger der Signaturanforderung abrufen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Empfänger der Signaturanforderung abrufen
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Weitergeleitete Signatur

Alternativ kannst du Empfänger an die gehostete Signatur-Oberfläche senden. Sieh dir für Details denselben Leitfaden oben an.

6) Verfolge alles mit Webhooks

Höre auf Ereignisse wie erstellt, gesendet, angesehen, signiert und abgeschlossen, um dein System in Echtzeit zu aktualisieren. Der Leitfaden enthält HMAC-Verifizierung, Rotation, Wiederholungen und eine Produktions-Checkliste.

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

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

Webhook-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

Kurznotizen zur Architektur

• JWTs. Generiere sie serverseitig. Tokens für den Vorlagen-Editor sind kurzlebig; Tokens für den Editor für Signaturanforderungen laufen nach 7 Tagen ab.

• Workspaces für SaaS. Halte Kunden vollständig getrennt. Deine Operatoren arbeiten trotzdem von einer einzigen API aus.

• Preisgestaltung und Einführung. Beginne mit den enthaltenen kostenlosen Umschlägen und gehe dann live. Keine Mindestmengen. €0.029 pro Umschlag.

Wie geht es weiter?

1. Deinen ersten Workspace verbinden

2. Eine Vorlage hinzufügen

3. Deine erste Anfrage senden

4. Einbetten oder Weiterleitung wählen

5. Webhooks einrichten

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