Signature électronique : avertissements, codes de risque

Une étape de Signature électronique émet un avertissement lorsqu’un signataire ne peut pas ou ne souhaite pas signer : il refuse, a épuisé le nombre de codes autorisés, ne peut pas être associé à une identité vérifiée, ou un document ne correspond plus à ce qui lui a été présenté. Chaque avertissement interrompt la signature de ce signataire, de sorte qu’aucun document signé n’est émis pour ce signataire. L’impact de l’avertissement sur la décision dépend de votre configuration.

Vue d’ensemble

Un avertissement apparaît à deux endroits :

Sur l’élément du signataire dans signatures[], sous la forme { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" } dans warnings[]. Consultez le Rapport de signature électronique.
Dans l’activité de la session, étiqueté avec la fonctionnalité SIGNATURE, accompagné de son titre et de sa description. La console l’affiche dans l’onglet Signature de la session, et additional_data.signature_id renvoie vers le signataire.

Chaque code correspond à une règle. Définissez la règle sur DECLINE, REVIEW ou NO_ACTION par étape de workflow, dans l’onglet Règles de la console ou dans la configuration de l’étape. La règle détermine le verdict du signataire (Declined, In Review ou Approved) ainsi que la sévérité de l’avertissement (error, warning ou information). Les règles de statut personnalisé sur l’étape s’appliquent ensuite.

Une règle détermine la décision, et non le fait que les documents soient signés ou non. NO_ACTION permet au workflow de se poursuivre, mais le signataire n’a toujours pas signé. Vérifiez que status est à signed avant de vous fier à une signature.

Avertissements générés

Code	Déclenchement	Règle et valeur par défaut
`SIGNATURE_DECLINED`	Le signataire a refusé de signer. Aucun exemplaire signé n’est émis et rien n’est facturé.	`signature_declined_action`, par défaut `REVIEW`
`SIGNATURE_OTP_FAILED`	Le signataire a saisi 3 codes erronés ou a demandé plus de 5 codes.	`signature_otp_failed_action`, par défaut `DECLINE`
`SIGNATURE_NAME_MISMATCH`	KYB : le nom déclaré pour la personne clé ne correspond pas à son nom vérifié, sans tenir compte de la casse ni des espaces.	`signature_name_mismatch_action`, par défaut `DECLINE`
`SIGNATURE_IDENTITY_NOT_VERIFIED`	Le signataire n’a aucune vérification d’identité approuvée comportant un nom, une détection du vivant n’est pas approuvée dans sa session, ou la vérification d’identité a été modifiée après le début du processus par le signataire.	`signature_identity_not_verified_action`, par défaut `DECLINE`
`SIGNATURE_DOCUMENT_CHANGED`	Un document ne correspond plus au SHA-256 enregistré lorsqu’il a été présenté au signataire.	`signature_document_changed_action`, par défaut `DECLINE`

Les vérifications d’identité et de nom s’exécutent lorsque le signataire demande son code puis à nouveau lorsqu’il le saisit ; ces avertissements apparaissent donc à ce moment-là plutôt qu’à l’ouverture de l’étape.

Les refus peuvent être annulés

SIGNATURE_DECLINED est le seul avertissement qu’un signataire peut annuler. Tant que le lien de signature est valide, un signataire ayant refusé peut rouvrir l’étape et signer. La réouverture efface l’avertissement du signataire ainsi que sa lecture et son accord sur chaque document, de sorte qu’il consulte à nouveau les documents. L’avertissement disparaît de l’activité de la session dès lors qu’aucun signataire de l’étape n’est plus en situation de refus. La réouverture ne réinitialise pas le nombre de tentatives de code. Les autres avertissements sont définitifs pour ce signataire.

Problèmes rencontrés par le signataire

Ces situations bloquent le signataire sans émettre d’avertissement. Le parcours lui indique ce qui s’est passé.

Situation	Ce qui se passe
Le lien de signature a expiré	L’étape ne peut plus être ouverte ni complétée après `expires_at`. Le lien reste valide pendant `signature_link_validity_days` à compter de la création de la session.
Le code a expiré	Les codes sont valables 5 minutes. Le signataire en demande un nouveau.
Un nouveau code a été demandé trop tôt	Le signataire doit attendre 60 secondes entre chaque demande de code.
Aucun contact vérifié	Le code est envoyé uniquement à un e-mail ou à un numéro de téléphone vérifié plus tôt au cours de la session. Ajoutez la Vérification de l’e-mail ou la Vérification du téléphone avant l’étape de signature.
Un champ obligatoire est vide	Le signataire ne peut pas terminer un document tant que tous les champs obligatoires ne sont pas renseignés. Le parcours affiche le nombre de champs restants et redirige vers le premier d’entre eux.
La valeur d’un champ est refusée	Toute valeur ne respectant pas la validation de son champ (par exemple si elle est trop longue ou n’est pas un nombre) est refusée, et le parcours en explique la raison.
L’application est trop ancienne pour les champs	Une version du SDK natif ne prenant pas en charge les champs ne peut pas afficher un document comportant des champs, et l’étape affiche une erreur. Les documents sans champs continuent de fonctionner. Consultez L’expérience de signature.

Exemple

{
  "signatures": [
    {
      "id": "0e6c2a8e-6c2f-4b8e-9a51-3f2f6a7d9b10",
      "node_id": "feature_signature",
      "status": "declined",
      "verdict": "In Review",
      "warnings": [
        { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }
      ],
      "declined_at": "2026-11-03T10:41:40.320Z",
      "declined_action": "REVIEW",
      "signed_at": null,
      "certificate": null,
      "timestamp": null,
      "evidence_file": null
    }
  ]
}

L’exemple montre uniquement les champs modifiés. Tous les autres champs de l’objet signature restent présents.

Types d’avertissements

La sévérité de chaque avertissement dépend de la règle que vous avez définie. Les sévérités se répartissent en trois catégories :

Authentification

Vérification

Surveillance

Plateforme

Signature électronique : avertissements, codes de risque

Vue d’ensemble

Avertissements générés

Les refus peuvent être annulés

Problèmes rencontrés par le signataire

Exemple

Types d’avertissements

Voir aussi

​Vue d’ensemble

​Avertissements générés

​Les refus peuvent être annulés

​Problèmes rencontrés par le signataire

​Exemple

​Types d’avertissements

​Voir aussi

Vue d’ensemble

Avertissements générés

Les refus peuvent être annulés

Problèmes rencontrés par le signataire

Exemple

Types d’avertissements

Voir aussi