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

Sind Sie ein Entwickler und haben bereits Ihr Firma-Konto? Perfekt. Dieser Leitfaden bringt Sie von „API key in hand” zu einem Live-Signing-Flow. Wir halten es schlank, konzentrieren uns auf Entscheidungen und verlinken Sie direkt zu funktionierenden Snippets in den Dokumentationen.

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 Signing-Anfrage senden

4. Das Signiererlebnis einbetten oder umleiten

5. Alles mit Webhooks verfolgen

Die Preisgestaltung ist einfach. Es kostet €0,029 pro Umschlag, die ersten 25 Umschläge sind kostenlos, damit Sie alles von Anfang bis Ende aufbauen und testen können.

Voraussetzungen

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

• Eine PDF-Datei, die Sie in eine Vorlage umwandeln können

• Ein Ort zum Ausführen von Servercode für JWT-Erzeugung und Webhooks

Benötigen Sie eine Auffrischung zum gesamten Ablauf? Sehen Sie sich den vollständigen Einrichtungsleitfaden an.

1) Erstellen Sie einen Workspace für jeden Kunden

Workspaces bieten jedem Kunden einen privaten, getrennten Bereich mit isolierten Vorlagen, Dokumenten und Nutzung. Es ist der sauberste Weg, eine SaaS-ähnliche, mandantenfähige Trennung zu erstellen, ohne Daten zwischen den Kunden zu leaken.

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

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

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

Hilfreich: Workspace-Einstellungen wie E-Mail-Kopie und Zeitzone sind pro Workspace.

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

2) Erstellen Sie eine wiederverwendbare Vorlage

Vorlagen halten das PDF plus Rollen und Felder, sodass Sie dasselbe Dokument viele Male mit unterschiedlichen Empfängern senden können.

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

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

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

Option A: Lassen Sie Benutzer Vorlagen in Ihrer App entwerfen

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

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Generieren Sie das Token serverseitig.

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

3) Erstellen Sie die Signing-Anfrage

Verwandeln Sie Ihre Vorlage in eine Live-Transaktion. Sie können auch von einem rohen PDF erstellen, wenn Sie es bevorzugen. Die Referenz behandelt Empfänger, Felder, Erinnerungen und Validierungsregeln.

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Optional: Lassen Sie Geschäftsanwender Details ausfüllen und von Ihrer UI senden

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

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Generieren Sie das JWT serverseitig.

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

4) Senden Sie die Signing-Anfrage

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

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

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

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

5) Lieferung des Signierens in Ihrem Produkt oder per Umleitung

Eingebettetes Signieren

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

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

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Sie holen die signing_request_user_id von der API ab.

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

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

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

Signieren per Umleitung

Alternativ können Sie Empfänger zur gehosteten Signing-Oberfläche senden. Siehe den gleichen Leitfaden oben für Details.

6) Verfolgen Sie alles mit Webhooks

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

Webhooks guide
https://docs.firma.dev/guides/webhooks

Webhooks guide
https://docs.firma.dev/guides/webhooks

Webhooks guide
https://docs.firma.dev/guides/webhooks

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

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

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

Architektonische Schnellnotizen

• JWTs. Erzeugen Sie sie serverseitig. Vorlage-Editor-Token sind kurzlebig; Signing-Anfrage-Editor-Token laufen nach 7 Tagen ab.

• Workspaces für SaaS. Halten Sie Kunden vollständig getrennt. Ihre Betreiber arbeiten dennoch von einer einzigen API aus.

• Preisgestaltung und Einführung. Beginnen Sie mit den inbegriffenen kostenlosen Umschlägen, dann gehen Sie live. Keine Mindestanforderungen. €0,029 pro Umschlag.

Was kommt als Nächstes?

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 Umleitung

5. Binden Sie Webhooks ein

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