Unterschriften aus Ihrer eigenen Software.

1. Schritt 1

   Anfrage erstellen

   Ein POST /v1/signing-requests mit dem PDF, den Unterzeichnern und der Feldplatzierung: anchors findet [[ls:signature:client]]-Marker im PDF, explicit nimmt Koordinaten, auto_append hängt eine Unterschriftsseite an. Die Antwort enthält die documentId und pro Unterzeichner eine signingUrl.

   In der Dokumentation

   curl https://api.wesign.now/v1/templates/$TEMPLATE_ID/instantiate \
     -H "Authorization: Bearer $WSK_KEY" \
     -H "Idempotency-Key: case-4711/mandate" \
     -H "Content-Type: application/json" \
     -d '{
       "recipients": [{ "slot": 1, "email": "anna@example.ch", "name": "Anna Muster" }],
       "field_values": { "company.legal_name": "Muster AG", "company.tax_id": "CHE-123.456.789" },
       "metadata": { "case_id": "4711" }
     }'

   Derselbe Versand aus einer gesperrten Vorlage: POST /v1/templates/{id}/instantiate fügt Ihre field_values in die {{Platzhalter}} ein und lädt die Empfänger ein.

2. Schritt 2

   Ihr Unterzeichner unterschreibt

   Wir senden die Einladung in der Sprache des Unterzeichners von Ihrer gebrandeten Subdomain — oder Sie liefern den Link selbst mit send_emails: false. Mit Mobilnummer und require_sms_verification gibt der Unterzeichner zuerst einen Einmalcode ein: eine fortgeschrittene elektronische Signatur (AES) statt der E-Mail-Link-Stufe (SES).

   In der Dokumentation

   "signers": [{
     "email": "anna@example.ch",
     "role": "client",
     "name": "Anna Muster",
     "locale": "de",
     "phone_e164": "+41791112233",
     "require_sms_verification": true
   }]
   
   # The invitation goes out in German from your branded subdomain.
   # Anna asks for the code on the signing page; the signature is AES once verified.
   # Deliver the link yourself instead: send_emails=false

3. Schritt 3

   Sie erhalten das Event

   Registrieren Sie einmal einen Webhook für den Workspace oder übergeben Sie callback_url pro Anfrage. Jede Zustellung ist HMAC-SHA256-signiert, wird mit exponentiellem Backoff wiederholt und in einem Zustellprotokoll geführt, aus dem Sie erneut zustellen können. document.completed kommt einmal pro Dokument mit signed_pdf_url, audit_trail_url und dem sha256 der Datei.

   In der Dokumentation

   POST https://your-app.example/wesign/callback
   X-WeSign-Event: document.completed
   X-WeSign-Signature: t=1757404800,v1=9c3b…a2f1
   
   {
     "event": "document.completed",
     "document_id": "8a1e4f9a-…",
     "metadata": { "case_id": "4711" },
     "signed_pdf_url": "https://api.wesign.now/v1/documents/8a1e4f9a-…/signed",
     "audit_trail_url": "https://api.wesign.now/v1/documents/8a1e4f9a-…/audit-trail",
     "sha256": "4f9a…d21c", …
   }

4. Schritt 4

   Dateien abholen

   GET /v1/documents/{id}/signed liefert das PAdES-versiegelte PDF, alle Unterschriften unter einem Siegel; /audit-trail rendert das Ereignisprotokoll — SHA-256, Zeitstempel, maskierte IPs — als PDF, immer auf Englisch. Beide brauchen Ihren Key. Vergleichen Sie den Hash und speichern Sie beide Dateien bei sich.

   In der Dokumentation

   curl -LOJ -H "Authorization: Bearer $WSK_KEY" \
     https://api.wesign.now/v1/documents/$DOC_ID/signed
   
   curl -OJ -H "Authorization: Bearer $WSK_KEY" \
     https://api.wesign.now/v1/documents/$DOC_ID/audit-trail
   
   # Compare the file's SHA-256 with the event's sha256, then store both files on your side.

Jede Antwort trägt eine X-Request-Id, und Einstellungen → API führt 30 Tage lang ein API-Protokoll jedes Aufrufs — Status, Fehlercode, betroffenes Dokument; Bodies werden nie gespeichert. Ein Idempotency-Key macht einen wiederholten Versand oder Instantiate sicher. Jeder Key darf 60 Anfragen pro Minute stellen.