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 signatureRequired signature authentification
Simple eSignatureNo (optional)
Advanced eSignatureYes
Qualified eSignatureNo

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.

Modesignature_authentication_modeComment
One-time-Password sent by SMSotp_smsSigner phone_number is required
One-time-Password sent by Emailotp_emailSigner phone_number is optional
No One-time-Passwordno_otpSigner 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.