E-Signatur in Ihr Produkt integrieren
Starten Sie Signaturanfragen aus Ihrem Backend und geben Sie jedem Unterzeichner einen gebrandeten Link auf Ihrer eigenen Subdomain — oder betten Sie die Signaturansicht direkt in Ihre Seite ein. Ihre Unterzeichner brauchen so oder so kein wesign.now-Konto. Die REST-API ist in jedem Plan enthalten, eingebettetes Signieren im Enterprise-Plan.
Ein POST an /v1/signing-requests mit dem PDF (Bytes oder URL), den Unterzeichnern und einem Platzierungsmodus. Die Felder werden beim Aufruf gesetzt — über Anker in Ihrem PDF, explizite Koordinaten oder eine angehängte Unterschriftsseite.
Die Antwort enthält pro Unterzeichner eine signingUrl auf ihrefirma.wesign.now. Öffnen Sie sie in einem neuen Tab oder leiten Sie dorthin weiter — kein Login, kein wesign.now-Konto. Verlangen Sie pro Unterzeichner einen SMS-Code, wenn Sie das fortgeschrittene Niveau (AES) brauchen.
Ein signierter Webhook wird ausgelöst, sobald ein Unterzeichner fertig ist, und noch einmal, wenn das Dokument abgeschlossen ist — mit einer per Key authentifizierten URL zum versiegelten PDF (PAdES-B) und zum Audit-Trail. Oder fragen Sie GET /v1/documents/{id} ab.
POST https://api.wesign.now/v1/signing-requests
Authorization: Bearer wsk_live_…
Content-Type: application/json
{
"file_url": "https://files.acme.com/msa.pdf",
"placement": "anchors",
"signers": [
{ "role": "customer", "email": "ann@acme.com", "name": "Ann Example",
"phone_e164": "+41791234567", "require_sms_verification": true },
{ "role": "legal", "email": "legal@acme.com" }
],
"callback_url": "https://app.acme.com/wesign/callback"
}
→ 201 {
"documentId": "8a1e4f9a-…",
"status": "pending",
"signers": [
{ "role": "customer", "email": "ann@acme.com", "status": "pending",
"signingUrl": "https://acme.wesign.now/en/sign/7b1c…", "signingRequestId": "…" },
{ "role": "legal", "email": "legal@acme.com", "status": "pending",
"signingUrl": "https://acme.wesign.now/en/sign/9d2e…", "signingRequestId": "…" }
],
"callback": { "url": "https://app.acme.com/wesign/callback", "secret": "whsec_…" }
}Alles, was Sie für den Go-live brauchen
Unterzeichner sind Gäste, erkannt an ihrer E-Mail-Adresse: Link öffnen, unterschreiben, fertig — ohne sich je bei wesign.now zu registrieren.
Unterschrieben wird auf ihrefirma.wesign.now — mit Ihrem Logo, Ihren Farben und Ihrer Reply-to-Adresse. Es sieht aus wie Ihr Produkt, nicht wie unseres.
Ihr Nutzer, seine Gegenpartei oder beide — bis zu 20 Unterzeichner pro Anfrage, parallel oder in fester Reihenfolge, jeder mit eigenem Link.
Setzen Sie require_sms_verification und pro Unterzeichner eine Telefonnummer. Ihre Unterzeichner bestätigen vor dem Unterschreiben einen Einmalcode (oder schon bevor sich das Dokument öffnet, mit sms_gate: before_view); die Prüfung wird im Audit-Trail festgehalten, und die Signatur gilt als fortgeschritten (AES).
Ein PAdES-B-Siegel auf jedem signierten PDF, zulässig nach eIDAS und ZertES, ein RFC-3161-Zeitstempel über die signierte Datei — in unseren Aufzeichnungen und auf dem Audit-Zertifikat —, dazu ein Audit-Trail-PDF, das Sie per API herunterladen können. Das Niveau jeder Signatur wird festgehalten und ist prüfbar.
HMAC-signierte Events für jede Unterschrift und für den Abschluss, mit einer per Key authentifizierten URL zum versiegelten PDF. Signatur prüfen, Datei abholen, speichern.
Unterschreiben direkt in Ihrer eigenen Seite
Ihr Backend tauscht eine Signaturanfrage gegen eine kurzlebige Sitzung und erhält eine URL zurück, die Sie in ein iframe oder eine mobile Webview einsetzen. Der Frame zeigt das Dokument, die Felder dieses Unterzeichners und die Signaturaktion — sonst nichts: kein Konto, keine Navigation, keine wesign.now-Oberfläche. Ihre Akzentfarbe, Ihre Schrift, Ihr Logo.
- Eine kurzlebige Sitzung für einen einzelnen Unterzeichner, serverseitig mit Ihrem API-Key ausgestellt: eine Signaturanfrage, ein Dokument, wenige Minuten gültig — nie ein API-Key im Browser.
- Eine Ancestor-Origin pro Sitzung — Ihr Backend nennt die Seite, die die Ansicht einbettet, und der Frame antwortet mit einer frame-ancestors-Richtlinie nur für diese Origin. Beschränken Sie einen Key zusätzlich auf eine Liste von Origins — als zweites Schloss.
- Theme und Sprache werden beim Ausstellen übergeben — Akzentfarbe, Schrift, Logo, Eckenradius —, und im Frame erscheint nichts von unserem eigenen Branding.
- Ein versioniertes postMessage-Schema (ready, viewed, signed, declined, expired, error), damit Ihre Seite den Vorgang sofort weiterführen kann — massgeblich bleibt der Webhook.
POST https://api.wesign.now/v1/embedded/sign-sessions
Authorization: Bearer wsk_live_…
{ "signing_request_id": "3f1c9e2a-…",
"origin": "https://portal.example.com",
"ttl_seconds": 300, "locale": "de" }
→ 201 { "embed_url": "https://acme.wesign.now/de/embed/sign/b7c2…",
"expires_at": "…" }Die genaue Spezifikation — Ausstellen, die zu veröffentlichenden CSP-Direktiven, das postMessage-Schema, Theming, Token-Lebensdauer und Widerruf — steht auf der Dokumentationsseite zum eingebetteten Signieren, samt einer Host-Seite zum Kopieren als Ausgangspunkt.
Versiegeltes, protokolliertes Unterschreiben in Ihr Produkt integrieren
Der gehostete Ablauf ist in jedem Plan mit REST-API enthalten. Eingebettetes Signieren — Embed-Sitzungen, Origins pro Sitzung und postMessage-Events — ist eine Enterprise-Funktion; sprechen Sie uns an, und wir richten Ihren Workspace ein.