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.
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.
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.
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.
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
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.
Ondertekenen gebeurt op jouwbedrijf.wesign.now, met je logo, kleuren en antwoordadres. Het ziet eruit als jouw product, niet als het onze.
Je gebruiker, diens wederpartij of allebei — tot 20 ondertekenaars per verzoek, tegelijk of in een vaste volgorde, elk met een eigen link.
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).
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.
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.
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.
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.