White-label ondertekenen · via API

Voeg elektronisch ondertekenen toe aan je product

Start ondertekenverzoeken vanuit je backend en geef elke ondertekenaar een link in je huisstijl op je eigen subdomein — of bed de ondertekenweergave rechtstreeks in je pagina in. Hoe dan ook hebben ze geen wesign.now-account nodig. De REST-API zit in elk abonnement, ingebed ondertekenen in het Enterprise-abonnement.

Zo werkt het vandaag
1
Je backend maakt het ondertekenverzoek aan

Eén POST naar /v1/signing-requests met de PDF (bytes of een URL), de ondertekenaars en een plaatsingsmodus. De velden worden bij de aanroep geplaatst — via ankers in je PDF, expliciete coördinaten of een toegevoegde handtekeningpagina.

2
Geef je gebruiker de link in je huisstijl

Het antwoord bevat per ondertekenaar een signingUrl op jouwbedrijf.wesign.now. Open die in een nieuw tabblad of leid je gebruiker ernaartoe — geen login, geen wesign.now-account. Vraag per ondertekenaar om een sms-code als je geavanceerde zekerheid (AES) nodig hebt.

3
Ontvang de verzegelde PDF terug

Een ondertekende webhook gaat af zodra een ondertekenaar klaar is en nogmaals wanneer het document af is, met een URL naar de verzegelde PDF (PAdES-B) en de audittrail, beveiligd met je sleutel. Of vraag GET /v1/documents/{id} periodiek op.

één aanroep → per ondertekenaar een ondertekenlink in je huisstijl
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 wat je nodig hebt om het live te zetten

Geen account voor je ondertekenaars

Ondertekenaars zijn gasten, herkend aan hun e-mailadres. Ze openen de link, tekenen en zijn klaar — ze maken nooit een account aan bij wesign.now.

Jouw merk op elke pagina

Ondertekenen gebeurt op jouwbedrijf.wesign.now, met je logo, kleuren en antwoordadres. Het ziet eruit als jouw product, niet als het onze.

Eén verzoek, zoveel ondertekenaars als nodig

Je gebruiker, diens wederpartij of allebei — tot 20 ondertekenaars per verzoek, tegelijk of in een vaste volgorde, elk met een eigen link.

Extra sms-stap als je AES nodig hebt

Stel per ondertekenaar require_sms_verification en een telefoonnummer in. De ondertekenaar bevestigt een eenmalige code vóór het tekenen (of voordat het document opent, met sms_gate: before_view); de controle komt in de audittrail en de handtekening geldt als geavanceerd (AES).

Verzegeld, met tijdstempel + controleerbaar

Een PAdES-B-zegel op elke ondertekende PDF, toelaatbaar onder eIDAS en ZertES, een RFC 3161-tijdstempel over het ondertekende bestand, bewaard in onze registers en vermeld op het auditcertificaat, plus een audittrail-PDF die je via de API kunt downloaden. Het betrouwbaarheidsniveau van elke handtekening wordt vastgelegd en is verifieerbaar.

Ondertekende webhooks, verzegelde PDF via URL

HMAC-ondertekende events voor elke handtekening en bij voltooiing, met een URL naar de verzegelde PDF, beveiligd met je sleutel. Controleer de handtekening, haal het bestand op, bewaar het.

Ondertekenen in je pagina · Enterprise

Onderteken binnen je eigen pagina

Je backend ruilt een ondertekenverzoek in voor een kortlevende sessie en krijgt een URL terug die je in een iframe of een mobiele webview plaatst. Het frame toont het document, de velden van die ondertekenaar en de ondertekenactie — verder niets: geen account, geen navigatie, geen wesign.now-interface. Jouw accentkleur, jouw lettertype, jouw logo.

  • Een kortlevende sessie voor één ondertekenaar, server-side aangemaakt met je API-sleutel: één ondertekenverzoek, één document, enkele minuten — nooit een API-sleutel in de browser.
  • Eén ancestor-origin per sessie — je backend noemt de pagina die de weergave inbedt, en het frame antwoordt met een frame-ancestors-beleid voor alleen die origin. Beperk een sleutel tot een lijst origins voor een tweede slot.
  • Thema en taal worden bij het aanmaken meegegeven — accentkleur, lettertype, logo, hoekradius — en in het frame staat niets van onze eigen merkinterface.
  • Een geversioneerd postMessage-schema (ready, viewed, signed, declined, expired, error), zodat je pagina meteen de volgende stap kan zetten, terwijl de webhook de bron van waarheid blijft.
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": "…" }

Het exacte contract — aanmaken, de CSP-directives die je publiceert, het postMessage-schema, thema's, levensduur en intrekking van tokens — staat op de documentatiepagina over ingebed ondertekenen, met een kant-en-klare hostpagina om mee te beginnen.

Enterprise

Voeg verzegeld, controleerbaar ondertekenen toe aan je product

De gehoste flow zit in elk abonnement met de REST-API. Ondertekenen in je pagina — embed-sessies, origins per sessie en postMessage-events — is een Enterprise-functie; neem contact met ons op en we richten je werkruimte in.