Sandbox gratuita
Chiavi di prova con le stesse rotte e lo stesso codice della produzione, senza addebiti: il codice OTP è sempre 000000.
API di firma elettronica
API di firma elettronica: integra la firma online nel tuo software
L'API REST di NuvaSign porta la firma elettronica con codice OTP dentro il tuo gestionale, CRM o app. Una chiamata per inviare il PDF, un link di firma via SMS o email, un webhook quando il documento è firmato, sigillato e con marca temporale qualificata.
POST /v1/signature-requests { "title": "Contratto di fornitura", "signers": [{ "first_name": "Mario", "phone": "+393331234567", "otp": "sms" }], "delivery": "sms" }
201 Created
{
"status": "pending",
"sign_url": "https://app.nuvasign.it/f/…"
}Link inviato via SMSMario · in attesa di firma
signature_request.completedWebhook · PDF sigillato
curl -X POST https://app.nuvasign.it/v1/signature-requests \
-H "Authorization: Bearer $NUVASIGN_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 8f14e45f-ceea-467b-b7d1-2a6c9e0f1a3d" \
-d '{
"document": { "url": "https://esempio.it/contratto.pdf" },
"signers": [{
"first_name": "Mario",
"last_name": "Rossi",
"phone": "+393331234567",
"otp": "sms"
}],
"delivery": "sms",
"external_id": "contratto-1234"
}'Come funziona l'API di firma
- Invii il PDF e i firmatari a
POST /v1/signature-requests. - Ogni firmatario riceve il suo link via SMS o email, oppure lo consegni tu.
- Firma a distanza dal browser, senza installare nulla, confermando con un codice OTP.
- Ricevi il webhook
signature_request.completede scarichi il PDF sigillato con la marca temporale.
Funzionalità
Tutto quello che serve per integrare la firma elettronica
Un'API REST pensata per chi sviluppa, con documentazione in italiano ed esempi pronti da copiare.
Webhook firmati
Un evento firmato HMAC quando la richiesta si completa, viene rifiutata, scade o è annullata, con ritentativi automatici.
Idempotenza
Ogni creazione porta una Idempotency-Key: un ritentativo di rete non consuma firme due volte.
OTP via SMS o email
Scegli per ogni firmatario il canale del codice e chi consegna il link: NuvaSign oppure il tuo software.
Fino a 20 firmatari
Più firmatari sullo stesso PDF, ognuno con il proprio link: il documento si sigilla quando hanno firmato tutti.
Valore legale eIDAS
Sigillo elettronico qualificato PAdES, marca temporale qualificata e pacchetto di prova scaricabile via API.
Casi d'uso
Cosa puoi automatizzare con l'API di firma
Ogni flusso in cui un documento aspetta una firma. Se rivendi la firma ai tuoi clienti, c'è anche l'offerta white label per software house.
Gestionali e ERP
Ordini, contratti e DDT firmati dal cliente senza uscire dal gestionale.
CRM e vendite
Il preventivo parte in firma appena l'offerta è pronta; lo stato torna nel CRM via webhook.
Portali e app clienti
Onboarding, adesioni e consensi firmati a distanza dentro il tuo percorso digitale.
Energia, telco e utility
Contratti di fornitura e variazioni firmati subito dopo la chiamata dell'operatore.
HR e software paghe
Lettere di assunzione, NDA e policy firmate dai collaboratori, archiviate in automatico.
Immobiliare e assicurazioni
Proposte, mandati e moduli firmati da remoto, con prova completa di ogni passaggio.
Prezzi API
Prezzi dell'API di firma elettronica
Paghi le firme, non le chiamate. Sigillo, marca temporale qualificata e codice OTP sono sempre compresi; le chiavi di prova sono gratuite.
API Pro
Per software house che integrano la firma nel proprio prodotto.
299,00 € al mese
- 300 firme incluse ogni mese
- Firme extra prepagate da 1,10 € a 0,90 € l'una
- Logo e colori del partner sulla pagina di firma
- API REST, webhook e assistenza dedicata
Volume
Da 1.000 firme al mese garantite, a contratto.
Su misura
- Minimo mensile garantito a partire da 1.000 firme
- Prezzo a firma concordato su misura
- Firme extra prepagate quando servono, come negli altri piani
- Logo e colori del partner, assistenza dedicata
FAQ
Domande frequenti sull'API di firma
Cos'è un'API di firma elettronica?
È un'interfaccia che permette al tuo software (gestionale, CRM, portale clienti, app) di inviare documenti in firma e ricevere l'esito in automatico, senza che i tuoi utenti escano dal tuo prodotto. Con l'API di NuvaSign crei una richiesta di firma con una chiamata POST, i firmatari confermano con un codice OTP e un webhook ti avvisa quando il PDF firmato e sigillato è pronto.
Posso provare l'API di firma gratis?
Sì. Dalla console crei una chiave di prova: stesse rotte, stesso codice e stessi webhook della produzione, senza addebiti. Il codice OTP è sempre 000000 e i PDF escono con la filigrana «TEST — senza valore legale». Per passare in produzione cambi solo la chiave.
Le firme raccolte via API hanno valore legale?
Sì, lo stesso delle firme inviate dalla console: firma elettronica ai sensi del Regolamento eIDAS con verifica OTP, sigillo elettronico qualificato, marca temporale qualificata e pacchetto di prova scaricabile via API. Le richieste create con una chiave di prova, invece, non hanno valore legale.
Come ricevo l'esito della firma?
Con un webhook firmato HMAC quando la richiesta si completa, viene rifiutata, scade o è annullata, con ritentativi automatici se il tuo server non risponde. Se non puoi esporre un endpoint, leggi gli stessi eventi via polling.
L'API supporta la firma digitale remota qualificata?
No. L'API di NuvaSign gestisce firme elettroniche con verifica OTP via SMS o email, chiuse con sigillo e marca temporale qualificati: coprono contratti, ordini, moduli e la maggior parte dei documenti aziendali, senza chiedere ai firmatari un certificato personale. Per gli atti che la legge riserva alla firma qualificata serve un prestatore di firma digitale.
Quanto costa l'API di firma elettronica?
API Pro costa 299 € al mese con 300 firme incluse, logo e colori del partner sulla pagina di firma; oltre, si comprano firme extra in anticipo da 1,10 € a 0,90 € l'una. Senza canone si possono anche comprare solo firme e usarle quando servono. Oltre le 1.000 firme al mese c'è il piano Volume a contratto. Sigillo, marca temporale e OTP sempre compresi.
Pronti quando lo sei tu
Pronto a integrare la firma elettronica?
Crea un account, genera una chiave di prova e manda la prima richiesta di firma in pochi minuti.