Firme dal tuo software.

1. Passo 1

   Crea la richiesta

   Un POST /v1/signing-requests con il PDF, i firmatari e il posizionamento dei campi: anchors trova i marcatori [[ls:signature:client]] nel PDF, explicit prende coordinate, auto_append aggiunge una pagina firma. La risposta contiene il documentId e una signingUrl per firmatario.

   Nella documentazione

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

   Lo stesso invio da un modello bloccato: POST /v1/templates/{id}/instantiate unisce i tuoi field_values nei {{placeholder}} e invita i destinatari.

2. Passo 2

   Il tuo firmatario firma

   Inviamo l'invito nella lingua del firmatario dal tuo sottodominio con il tuo brand — oppure consegni tu il link con send_emails: false. Aggiungi un numero di cellulare e require_sms_verification, e il firmatario inserisce prima un codice monouso: una firma elettronica avanzata (AES) invece del livello link e-mail (SES).

   Nella documentazione

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

   Ricevi l'evento

   Registra un webhook una volta per il workspace, oppure passa callback_url per richiesta. Ogni consegna è firmata HMAC-SHA256, ritentata con backoff esponenziale e registrata in un log di consegna da cui puoi riconsegnare. document.completed arriva una volta per documento con signed_pdf_url, audit_trail_url e lo sha256 del file.

   Nella documentazione

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

   Scarica i file

   GET /v1/documents/{id}/signed restituisce il PDF sigillato PAdES, tutte le firme sotto un unico sigillo; /audit-trail genera il registro eventi — SHA-256, marca temporale, IP mascherati — come PDF, sempre in inglese. Entrambi richiedono la tua chiave. Confronta l'hash e conserva entrambi i file da parte tua.

   Nella documentazione

   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.

Ogni risposta porta un X-Request-Id, e Impostazioni → API conserva per 30 giorni un log API di ogni chiamata — stato, codice di errore, documento interessato; i corpi non vengono mai salvati. Una Idempotency-Key rende sicuro un invio o un instantiate ritentato. Ogni chiave può fare 60 richieste al minuto.