> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Signature électronique : avertissements, codes de risque

> Découvrez avec Didit chaque avertissement de signature électronique, de SIGNATURE_DECLINED à SIGNATURE_DOCUMENT_CHANGED, et leurs règles.

Une étape de [Signature électronique](https://docs.didit.me/fr/core-technology/electronic-signature/overview.md) é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](https://docs.didit.me/fr/core-technology/electronic-signature/report-electronic-signature.md).
* 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](https://docs.didit.me/fr/management-api/workflows/feature-configs.md#signature-électronique) 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.

> [!WARNING]
>
> 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](https://docs.didit.me/fr/core-technology/electronic-signature/overview.md#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](https://docs.didit.me/fr/core-technology/electronic-signature/overview.md#l’expérience-de-signature). |

## Exemple

```json theme={null}
{
  "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](https://docs.didit.me/fr/core-technology/electronic-signature/report-electronic-signature.md#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 :

## Voir aussi

* [Vue d'ensemble de la signature électronique](https://docs.didit.me/fr/core-technology/electronic-signature/overview.md)
* [Rapport de signature électronique](https://docs.didit.me/fr/core-technology/electronic-signature/report-electronic-signature.md)
* [Configurations des fonctionnalités de workflow](https://docs.didit.me/fr/management-api/workflows/feature-configs.md#signature-électronique)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.