Handtekeningen vanuit je eigen software.

1. Stap 1

   Maak het verzoek

   Eén POST /v1/signing-requests met de pdf, de ondertekenaars en de veldplaatsing: anchors vindt [[ls:signature:client]]-markers in de pdf, explicit neemt coördinaten, auto_append voegt een handtekeningpagina toe. Het antwoord bevat de documentId en per ondertekenaar een signingUrl.

   In de documentatie

   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" }
     }'

   Dezelfde verzending vanuit een vergrendeld sjabloon: POST /v1/templates/{id}/instantiate voegt je field_values in de {{placeholders}} in en nodigt de ontvangers uit.

2. Stap 2

   Je ondertekenaar tekent

   Wij mailen de uitnodiging in de taal van de ondertekenaar vanaf je subdomein in jouw huisstijl — of je bezorgt de link zelf met send_emails: false. Voeg een mobiel nummer en require_sms_verification toe en de ondertekenaar voert eerst een eenmalige code in: een geavanceerde elektronische handtekening (AES) in plaats van het e-maillinkniveau (SES).

   In de documentatie

   "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. Stap 3

   Je krijgt het event

   Registreer één keer een webhook voor de workspace, of geef callback_url per verzoek mee. Elke levering is HMAC-SHA256-ondertekend, wordt met exponentiële backoff herhaald en staat in een leveringslog waaruit je opnieuw kunt leveren. document.completed komt één keer per document met signed_pdf_url, audit_trail_url en de sha256 van het bestand.

   In de documentatie

   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. Stap 4

   Haal de bestanden op

   GET /v1/documents/{id}/signed levert de PAdES-verzegelde pdf, alle handtekeningen onder één zegel; /audit-trail rendert het eventlog — SHA-256, tijdstempel, gemaskeerde IP's — als pdf, altijd in het Engels. Beide vereisen je key. Vergelijk de hash en bewaar beide bestanden aan jouw kant.

   In de documentatie

   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.

Elk antwoord draagt een X-Request-Id, en Instellingen → API bewaart 30 dagen een API-log van elke aanroep — status, foutcode, betrokken document; bodies worden nooit opgeslagen. Een Idempotency-Key maakt een herhaalde verzending of instantiate veilig. Elke key mag 60 verzoeken per minuut doen.