Set the signature level

How to set the signature level?

The signature level is specified at the Signer's level. The signature level must be specified in the signature_level property in the Signer payload. You will find below a payload example for a Simple eSignature level :

{
  "info": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]",
    "phone_number": "+33760047242",
    "locale": "en"
  },
  "signature_level": "electronic_signature",
  "signature_authentication_mode": "no_otp",
  "fields": [
    {
      "document_id": "{{documentId}}",
      "type": "signature",
      "page": 1,
      "width": 180,
      "x": 400,
      "y": 650
    }
  ]
}

The table below describe the signature_level property value that match the level of signature :

Level of signaturesignature_level valueRequired signature authentication mode
Simple eSignatureelectronic_signatureNo
Advanced eSignatureadvanced_electronic_signatureYes
Qualified eSignaturequalified_electronic_signatureNo

📘

Some signature levels require authentication (as mentioned in the previous table). Please refer to the corresponding section to learn more about signature authentication.

Signer payload example for Advanced eSignature with otp_sms authentication mode :

{
  "info": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]",
    "phone_number": "+33760047242",
    "locale": "en"
  },
  "signature_level": "advanced_electronic_signature",
  "authentication_mode": "otp_sms",
  "fields": [
    {
      "document_id": "{{documentId}}",
      "type": "signature",
      "page": 1,
      "width": 180,
      "x": 400,
      "y": 650
    }
  ]
}

📘

All signature levels can be used in sandbox mode, please refer to the following section for more information.