Come scelgo il modo in cui un firmatario dimostra la propria identità?

Imposta validationMode su quel firmatario. Il valore predefinito, "sign", è il più rapido: un segno più un gesto esplicito di conferma a scorrimento, nessun codice. "email" aggiunge un codice monouso inviato all'indirizzo del firmatario prima che il suo segno abbia valore:

"signers": {
  "A": { "email": "...", "fullName": "...", "validationMode": "email",
         "fields": [ /* ... */ ] }
}

"sms" funziona come "email" — si richiede un codice e lo si inserisce — ma il codice arriva per SMS al telefono del firmatario. Richiede un campo "phone" su quel firmatario (testo libero, in qualsiasi formato). Quando il codice non può essere consegnato via SMS (nessun gateway configurato, o un paese in cui il mittente non è registrato) la busta viene rifiutata alla creazione con SMS_VALIDATION_UNAVAILABLE, e nulla viene creato né inviato.

Il codice via SMS è un servizio che la tua organizzazione acquista. Lo attiviamo noi per te; fino ad allora una richiesta che chiede "sms" (o un'organizzazione con sms come impostazione predefinita) viene rifiutata con FEATURE_NOT_ENABLED e details.feature impostato a smsValidation, non viene creato nulla e nulla viene inviato di nascosto per email al suo posto. Se il servizio viene ritirato dopo l'invio di una busta, i suoi firmatari ricevono comunque il codice, per email: non si consuma nulla che la tua organizzazione non possiede più.

Ogni SMS costa due crediti, addebitati alla tua organizzazione quando il gateway SMS accetta il messaggio: un firmatario che chiede un nuovo codice riceve un nuovo messaggio, addebitato di nuovo (al massimo otto codici per firmatario). Un messaggio che non parte non viene addebitato. L'addebito non blocca mai il firmatario: il codice viene inviato anche se il saldo è esaurito, e il prossimo credito che aggiungi lo ripaga per primo. output.credits.used della busta include questi addebiti man mano che avvengono. Con un piano che prevede un contatore SMS, il codice viene preso prima dal piano e, superato quello, dal credito.

Tutti gli esiti che una chiamata su una busta può produrre: Esiti e codici di errore. Sostituire un firmatario che conferma via SMS, o un firmatario che passa ad altri il proprio turno, richiede il numero di cellulare della nuova persona: il vecchio numero non viene mai conservato e il codice non gli viene mai inviato (Sostituire un firmatario). I livelli di firma (SES/AES/QES) sono un asse separato dalla modalità di validazione — vedi Livelli di firma: SES, AES, QES.