Firma white-label · via API

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.

Come funziona oggi
1
Il tuo backend crea la richiesta di firma

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.

2
Consegna al tuo utente il link con il tuo brand

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).

3
Ricevi il PDF sigillato

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}.

una chiamata → un link di firma personalizzato per ogni firmatario
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

Nessun account per i tuoi firmatari

I firmatari sono ospiti, identificati dall’indirizzo e-mail. Aprono il link, firmano e hanno finito — non si registrano mai a wesign.now.

Il tuo brand su ogni pagina

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.

Una richiesta, tutti i firmatari che vuoi

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.

Verifica SMS in più quando ti serve l’AES

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).

Sigillata, con marca temporale + audit trail

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.

Webhook firmati, PDF sigillato via URL

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 nella pagina · Enterprise

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.

Enterprise

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.