Aggiungi la firma elettronica al tuo prodotto
Avvia richieste di firma dal tuo backend e consegna a ogni firmatario un link con il tuo brand sul tuo sottodominio — oppure integra la vista di firma direttamente nella tua pagina. In entrambi i casi, nessun account wesign.now per loro. L’API REST è inclusa in ogni piano; la firma integrata nel piano Enterprise.
Una richiesta POST a /v1/signing-requests con il PDF (byte o URL), i firmatari e una modalità di posizionamento. I campi vengono posizionati al momento della chiamata — ancore nel tuo PDF, coordinate esplicite o una pagina di firma aggiunta in fondo.
La risposta contiene una signingUrl per firmatario su tuaazienda.wesign.now. Aprila in una nuova scheda o reindirizza l’utente lì — niente login, nessun account wesign.now. Richiedi un codice SMS per firmatario quando ti serve un livello di garanzia avanzato (AES).
Un webhook firmato parte ogni volta che un firmatario completa la firma e di nuovo quando il documento è concluso, con un URL autenticato tramite chiave verso il PDF sigillato (PAdES-B) e l’audit trail. Oppure interroga GET /v1/documents/{id}.
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_…" }
}Tutto ciò che ti serve per lanciarlo
I firmatari sono ospiti, identificati dall’indirizzo e-mail. Aprono il link, firmano e hanno finito — non si registrano mai a wesign.now.
La firma avviene su tuaazienda.wesign.now con il tuo logo, i tuoi colori e il tuo indirizzo di risposta. Sembra il tuo prodotto, non il nostro.
Il tuo utente, la sua controparte o entrambi — fino a 20 firmatari per richiesta, in parallelo o in un ordine fisso, ognuno con il proprio link.
Imposta require_sms_verification e un numero di telefono per firmatario. Il firmatario conferma un codice monouso prima di firmare (o prima che il documento si apra, con sms_gate: before_view); la verifica finisce nell’audit trail e la firma viene classificata come avanzata (AES).
Un sigillo PAdES-B su ogni PDF firmato, ammissibile secondo eIDAS e ZertES, una marca temporale RFC 3161 sul file firmato, conservata nei nostri registri e riportata sul certificato di audit, più un PDF dell’audit trail scaricabile via API. Il livello di garanzia di ogni firma viene registrato ed è verificabile.
Eventi firmati HMAC per ogni firma e per il completamento, con un URL autenticato tramite chiave verso il PDF sigillato. Verifica la firma, scarica il file, archivialo.
Firma dentro la tua pagina
Il tuo backend scambia una richiesta di firma con una sessione di breve durata e riceve un URL da inserire in un iframe o in una webview mobile. Il frame mostra il documento, i campi di quel firmatario e l’azione di firma — nient’altro: nessun account, nessuna navigazione, nessun elemento dell’interfaccia wesign.now. Il tuo colore d’accento, il tuo font, il tuo logo.
- Una sessione di breve durata per un solo firmatario, emessa lato server con la tua chiave API: una richiesta di firma, un documento, pochi minuti — mai una chiave API nel browser.
- Una sola origine di incorporamento per sessione — il tuo backend indica la pagina che incorporerà la vista e il frame risponde con una policy frame-ancestors valida solo per quell’origine. Limita una chiave a un elenco di origini per un secondo livello di protezione.
- Tema e lingua passati al momento dell’emissione — colore d’accento, font, logo, raggio degli angoli — e nessun elemento del nostro brand all’interno del frame.
- Uno schema postMessage versionato (ready, viewed, signed, declined, expired, error), così la tua pagina può far avanzare subito la pratica, mentre il webhook resta la fonte di verità.
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": "…" }Il contratto esatto — emissione, direttive CSP da pubblicare, schema postMessage, tema, durata e revoca del token — è nella pagina della documentazione sulla firma integrata, con una pagina host da copiare e incollare per iniziare.
Aggiungi al tuo prodotto una firma sigillata e tracciata
Il flusso ospitato è disponibile in ogni piano che include l’API REST. La firma nella pagina — sessioni integrate, origini per sessione ed eventi postMessage — è una funzionalità Enterprise: parlaci e configureremo il tuo workspace.