Authentication mode

Authentication modes available

We offer several methods to authenticate your signers, depending on the Signature Level you choose, your documents' security requirements and the availability of the Signers phone number.

Three methods are available when it comes to authentication:

  • One-time-Password (OTP) sent by SMS
  • One-time-Password sent by Email
  • No One-time-Password

The availability of these different methods depends on the Signature Level, as shown in the table below.

Signature LevelAvailable authentication modesComment
Simple eSignature- no_otp
- otp_email
- otp_sms
Signers authentication only (no identification). Ideal for most signature requests.

Those options are available:

- One-time-Password sent by SMS
- One-time-Password sent by Email
- No One-time-Password OTP by email and SMS should be kept for documents requiring a higher level of security.
Advanced eSignature- otp_smsSigners will be identified by an identity check (ID document).

The One-time-Password sent by SMS is mandatory.
Qualified eSignature - nullSigners are identified by a double identity check (ID document and video face verification) or with their saved identity registered after their first identification.

Authentication with an OTP code is not relevant for this level of signature, as we perform a video verification of the face. However, this verification will require a mobile phone with a camera. Please ensure that the signer has one with them.

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": "en"
    },
  	"signature_level": "electronic_signature",
    "signature_authentication_mode": "otp_sms"
}
{
    "info": {
        "first_name": "Jane",
        "last_name": "Doe",
        "email": "[email protected]",
        "locale": "en"
    },
  	"signature_level": "electronic_signature",
    "signature_authentication_mode": "otp_email"
}
{
    "info": {
        "first_name": "Jane",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone_number": "+33700000000",
        "locale": "en"
    },
  	"signature_level": "electronic_signature",
    "signature_authentication_mode": "no_otp"
}