Choose the Signature Request authentication mode
According to the Signature level you choose, three methods are available when it comes to authentication:
- One-time-Password (OTP) sent by SMS
- One-time-Password (OTP) sent by Email
- No One-time-Password - no extra authentication
The table below describes the signature authentications that match to the signature level:
Level of signature | Required signature authentification |
---|---|
Simple eSignature | No (optional) |
Advanced eSignature | Yes |
Qualified eSignature | No |
The authentication mode is set at the signers level, in the signature_authentication_mode property in the signer payload.
It can be different for each signer.
Mode | signature_authentication_mode | Comment |
---|---|---|
One-time-Password sent by SMS | otp_sms | Signer phone_number is required |
One-time-Password sent by Email | otp_email | Signer phone_number is optional |
No One-time-Password | no_otp | Signer phone_number is optional |
In the following example, we have added 3 Signers, each with a different signature_authentication_mode
.
POST /signature_requests/{signatureRequestId}/signers
{
"info": {
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"phone_number": "+33700000000",
"locale": "fr"
},
"signature_authentication_mode": "otp_sms"
}
{
"info": {
"first_name": "Jane",
"last_name": "Doe",
"email": "[email protected]",
"locale": "fr"
},
"signature_authentication_mode": "otp_email"
}
{
"info": {
"first_name": "Jane",
"last_name": "Doe",
"email": "[email protected]",
"phone_number": "+33700000000",
"locale": "fr"
},
"signature_authentication_mode": "no_otp"
}
If you need more details, you can find them in this dedicated page.
Updated 8 months ago