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 signature	signature_level value	Required signature authentication mode
Simple eSignature	electronic_signature	No
Advanced eSignature	advanced_electronic_signature	Yes
Qualified eSignature	qualified_electronic_signature	No

📘
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.