Niveaux de signature
Le niveau Avancé (AES) applique uniquement la signature en PAdES. Les valeurs de
signature_format xades et cades sont refusées pour AES avec signature_format_not_supported. Vérifiez signature_availability sur le workflow avant d’enregistrer une étape AES : tant que aes est à false, l’enregistrement d’une nouvelle étape renvoie 400 avec aes_not_available.
Fonctionnement
1
Pour le niveau Avancé (AES), le workflow vérifie d'abord le signataire
Au niveau Avancé (AES), l’étape de signature s’exécute après les étapes qui établissent l’identité du signataire : la Vérification d’identité, et la Vérification de l’e-mail ou la Vérification du téléphone pour le point de contact auquel le code est envoyé. Consultez Avant de commencer. Le niveau Simple ne requiert aucune étape préalable.
2
Didit prépare les documents
Lorsque le signataire atteint l’étape, Didit copie les documents et leurs champs dans la session et enregistre le SHA-256 de chaque document. Les modifications ultérieures apportées au workflow ne peuvent pas modifier ce que voit ce signataire.
3
Le signataire consulte chaque document
Pour un document comportant des champs, le signataire est guidé de champ en champ. Il définit sa signature une seule fois, puis elle est appliquée à chaque champ de signature et d’initiales, et il remplit les champs de texte et les cases à cocher. Les valeurs que Didit extrait de l’identité vérifiée, de la session ou de votre système sont déjà renseignées sur la page. Pour un document sans champs, il le lit et l’approuve.
4
Pour le niveau Avancé (AES), le signataire confirme avec un code
Lorsqu’un document comporte des champs, le signataire accepte d’abord de signer les documents par voie électronique. Au niveau Avancé (AES), Didit envoie ensuite un code à six chiffres à l’e-mail ou au téléphone vérifié plus tôt dans la session, et sa saisie autorise la signature sur chaque document de l’étape. Au niveau Simple, il n’y a pas de code : c’est l’acceptation qui autorise la signature.
5
Didit signe et scelle
Didit renseigne la date de signature, appose la valeur de chaque champ sur chaque PDF et ajoute la page de preuve. Au niveau Avancé (AES), Didit applique ensuite la signature PAdES et l’horodatage, de sorte que la signature couvre l’ensemble des éléments de la page. Au niveau Simple, le fichier est un PDF accompagné de la page de preuve, sans signature numérique, cachet ni horodatage.
6
Vous recevez les résultats
La décision et les webhooks de session contiennent
signatures[] avec le signataire, la confirmation, le certificat, l’horodatage, les hachages de chaque document et la valeur de chaque champ. Vous téléchargez les PDF signés ainsi que le PDF de preuve, et Didit peut envoyer une copie par e-mail au signataire.Avant de commencer
Au niveau Avancé (AES), le signataire doit être vérifié avant de pouvoir signer. Didit extrait son nom et ses coordonnées directement des enregistrements vérifiés de la session, jamais de ce que vous ou le signataire saisissez. Le niveau Simple ne nécessite rien de tout cela : il ne comporte aucune vérification d’identité, d’e-mail ou de téléphone, ni aucun code, et il est refusé pour les signataires KYB. Pour la Vérification des utilisateurs (KYC), placez ces étapes avant la Signature électronique dans le workflow :- Vérification d’identité, approuvée, avec un nom lisible. Sans cela, l’étape enregistre
SIGNATURE_IDENTITY_NOT_VERIFIED. - Vérification de l’e-mail lorsque le code est envoyé par e-mail (par défaut), ou Vérification du téléphone lorsqu’il est envoyé par SMS. Le code est uniquement envoyé à un contact vérifié au sein de la même session.
- Si le workflow comporte également la Détection du vivant, celle-ci doit être approuvée.
Une étape KYB compte entre 1 et 20 signataires, et chacun doit avoir un KYC approuvé au moment de signer. Chacun signe son propre exemplaire des documents et confirme avec un code envoyé au contact vérifié dans sa propre session KYC. Le nom déclaré pour la personne clé doit correspondre à son nom vérifié, sans tenir compte de la casse ni des espaces, faute de quoi l’étape enregistre
SIGNATURE_NAME_MISMATCH. L’étape se termine une fois que chaque signataire a signé ou refusé.
Documents
D’où proviennent les documents
signature_documents_source définit où une étape obtient ses documents :
Les documents par session permettent de faire signer à une personne un contrat dont le nom, le montant ou les conditions ont déjà été renseignés par votre système.
Fichiers pris en charge
Lorsque vous importez un document Word, Didit le convertit en PDF pendant l’importation, en 60 secondes au maximum. Les pages converties correspondent à ce que le signataire voit et signe, vérifiez-les donc avant de positionner des champs : les sauts de ligne peuvent différer légèrement de Word. Le fichier Word et son PDF appartiennent au même document et sont supprimés avec lui. Le PDF de preuve enregistre la conversion et le SHA-256 des deux fichiers.
Didit refuse un fichier Word avec
signature_document_not_supported et un motif reason lorsque ce qui serait signé est ambigu : il contient des macros (macros), des révisions non acceptées (tracked_changes), des liens vers du contenu externe (external_links) ou des objets incorporés (embedded_objects). Acceptez ou rejetez les révisions avant l’importation, afin que le PDF présente le texte sur lequel vous vous êtes accordés.
Un fichier qui ne peut pas être converti est refusé avec signature_document_conversion_failed et l’un de ces motifs :
Champs sur le document
Les champs transforment un document en modèle que le signataire remplit, de la même manière que vous prépareriez une enveloppe dans un outil de signature bureautique. Un document sans champs conserve le parcours le plus simple : le signataire le lit et l’approuve.
Il n’y a pas de sélecteur de date dans cette version. Utilisez un champ
text pour une date saisie par le signataire.
Un champ possède ces propriétés :
role_not_used. Chaque rôle possédant des champs sur un document doit comporter au moins un champ signature ou initials sur celui-ci, sans quoi la version du workflow ne peut pas être publiée (signature_field_missing).
Validation
validation s’applique aux champs text :
kind:any;letters(lettres dans n’importe quel système d’écriture, espaces, traits d’union et apostrophes) ;number(chiffres avec un séparateur décimal facultatif) ;email; oupattern.min_length: de0jusqu’àmax_length.max_length: de1à500. Valeur par défaut120.pattern: obligatoire aveckind: "pattern". Une expression régulière de 200 caractères maximum à laquelle la valeur entière doit correspondre. Les lookarounds et les backreferences ne sont pas pris en charge.message: jusqu’à 120 caractères, affiché à la place de l’erreur par défaut.
Valeurs pré-remplies
prefill indique la source de la valeur d’un champ :
Un champ
data doit comporter un prefill. Un champ full_name utilise toujours identity.full_name et un champ email utilise contact.email, et un champ text peut également en comporter un. Les valeurs des champs data, full_name et email vérifiés sont figées lorsque le signataire commence à signer : les modifications ultérieures apportées à la session ne les modifient pas. Un champ text ou email pré-rempli est en lecture seule, sauf si vous définissez editable_when_prefilled.
Lorsque la source d’un champ obligatoire n’a pas de valeur à ce moment-là, par exemple dans une session sans adresse, le champ reste vide et le signataire peut tout de même signer. Aucun avertissement n’est émis, et value_unavailable_reason dans le rapport en indique la raison.
Configuration dans la console
- Accédez à Workflows, ouvrez un workflow et ajoutez l’étape Signature électronique après les étapes qui vérifient le signataire.
- Dans Documents, sélectionnez Téléverser pour ajouter des fichiers PDF ou Word, puis faites-les glisser dans l’ordre dans lequel le signataire les verra. Les fichiers Word sont convertis en PDF : vérifiez les pages converties avant de placer des champs. Remplacer remplace le fichier d’un document et conserve ses champs, à l’exception de ceux situés sur des pages que le nouveau fichier ne contient plus.
- Sous Placez les champs sur les documents, sélectionnez Ouvrir l’éditeur. Faites glisser un champ depuis la palette sur la page, ou sélectionnez-le et cliquez à l’endroit voulu, puis déplacez-le et redimensionnez-le. Pour chaque champ, définissez Qui le remplit, son libellé, s’il est Obligatoire, ce qu’il accepte, d’où provient sa valeur et sa Clé API (le
keydu champ). Aperçu côté signataire affiche le document tel que le signataire le voit sur mobile ou ordinateur. L’éditeur enregistre automatiquement vos modifications (Enregistré dans le brouillon) et liste les éléments à corriger avant de sélectionner Terminé. - Toujours dans Documents, choisissez la provenance des documents : Ce workflow, Chaque session ou Les deux. Pour les documents sans champs, choisissez si le signataire doit Lire jusqu’à la fin avant de signer et donner Un consentement par document.
- Dans Signature, choisissez le Signataire, le Niveau (Simple, par défaut, ou Avancé (AES) ; Qualifié (QES) s’affiche comme Prochainement), le Format et le canal de réception du code (Code à usage unique par).
- Dans Règles, définissez l’impact de chaque avertissement sur le verdict.
- Dans Avancé, choisissez si vous souhaitez Envoyer la copie signée par e-mail et Ajouter une page de preuves, ainsi que le nombre de jours pendant lesquels le lien de signature reste valide. Vous pouvez également ajouter des règles de statut personnalisées.
- Enregistrez le workflow.
L’expérience de signature
L’étape de signature s’exécute sur la page de vérification hébergée, dans le Web SDK et dans les SDK natifs, sur ordinateur comme sur mobile. Vous n’avez aucune interface utilisateur de signature à développer.- Introduction. Le signataire consulte les documents qu’il s’apprête à signer.
- Chaque document, dans l’ordre. Pour un document comportant des champs, le signataire est guidé à travers ses champs dans l’ordre de
position. Le premier champ de signature ou de paraphe ouvre un volet dans lequel il adopte une signature. Les champs facultatifs portent la mention Facultatif. Les valeurs préremplies par Didit s’affichent sur la page accompagnées d’un cadenas et ne constituent pas des étapes. Appuyer sur un champ sur la page permet d’y accéder directement. Sur mobile, les champs s’affichent un par un dans un volet maintenu au-dessus du clavier. Sur un écran d’au moins 1200 px de large, la page s’affiche à côté de la liste des champs. Terminer un document alors qu’un champ obligatoire est encore vide indique le nombre de champs restants et renvoie au premier. Un document sans champ est lu et accepté selon votre configuration. - Examen. Le signataire consulte à nouveau les documents et, si l’un d’eux comporte des champs, accepte de les signer électroniquement.
- Code (Advanced (AES) uniquement). Le signataire demande son code. Il est valable pendant 5 minutes, un nouveau code peut être envoyé après 60 secondes, et le signataire a droit à un maximum de 5 codes et 3 tentatives erronées. Lorsque l’une de ces limites est atteinte,
SIGNATURE_OTP_FAILEDest enregistré. Au niveau Simple, il n’y a pas de code : le signataire passe directement de l’examen à la signature. - Signé. Après la signature, le signataire peut télécharger ses documents signés. Si vous avez activé cette option, Didit lui envoie également une copie par e-mail.
- Refus. Le signataire peut refuser au lieu de signer. Cela enregistre
SIGNATURE_DECLINED. Un refus peut être rouvert tant que le lien de signature est valide, permettant ainsi au signataire de signer s’il change d’avis.
signature_link_validity_days (de 1 à 30, par défaut 7), à compter de la création de la session. La session reste ouverte au moins pendant cette durée.
Les SDK natifs affichent l’étape de signature à partir de la version qui l’intègre, répertoriée dans la vue d’ensemble des SDK natifs dès sa disponibilité. Les documents avec des champs nécessitent une version prenant en charge les champs : une version antérieure ne peut pas les afficher et l’étape présente une erreur à la place. Les documents sans champs fonctionnent avec toutes les versions incluant l’étape de signature. Tant que votre application n’exécute pas une version prenant en charge ce que votre workflow utilise, redirigez les utilisateurs vers la page hébergée ou le Web SDK.
Adopter une signature
Le signataire adopte sa signature et ses initiales une seule fois, dans un volet unique, la première fois qu’un document requiert l’une ou l’autre :- Saisie : son nom vérifié dans un style manuscrit de son choix, marqué Depuis votre pièce d’identité. Il ne peut pas saisir un autre nom. Les initiales saisies correspondent aux premières lettres de ce nom.
- Tracée : la signature et les initiales sont tracées avec le doigt ou la souris.
Résultats
Le résultat de chaque signataire est un élément designatures[] dans la décision de la session et dans la decision des webhooks de session. Il n’existe pas de webhook de signature distinct : l’événement status.updated de la session vous indique quand récupérer la décision.
Vous obtenez le PDF signé de chaque document, un PDF de preuve pour chaque signataire, ainsi que le SHA-256 de chaque fichier original et signé, afin de pouvoir prouver ultérieurement que rien n’a été modifié. Pour les documents comportant des champs, vous recevez également la valeur de chaque champ, sa provenance et l’heure à laquelle il a été renseigné, en plus de la signature adoptée et du moment où le signataire a accepté de signer électroniquement. Consultez le Rapport de signature électronique pour découvrir chaque champ, les téléchargements et la procédure pour revalider une signature.
Dans la console, l’onglet Signature de la session affiche les documents, puis un bloc Champs avec un aperçu de chaque page, la signature et les initiales adoptées, ainsi que la valeur, l’horodatage et la source de chaque champ. Le rapport PDF comprend une section de signature, ainsi qu’une page Signature électronique · champs lorsque les documents contiennent des champs.
Tarifs
La signature électronique coûte $0.10 par session signée, inclus dans votre crédit gratuit, quel que soit le nombre de documents lors d’une signature et quel que soit le niveau, Simple ou Advanced (AES). Une signature qui est refusée, échoue ou expire n’est pas facturée. Qualifiée (QES) est une option complémentaire qui n’est pas encore disponible et n’a pas de tarif fixé.Suppression des données de signature
Lorsque vous supprimez une session, ses données de signature sont supprimées avec elle : les documents envoyés avec la session et leurs fichiers Word d’origine, les copies préparées pour chaque signataire, les PDF signés, les PDF de preuve, les images de la signature et des initiales adoptées, ainsi que la valeur de chaque champ. Leurs liens de téléchargement cessent de fonctionner. Il en va de même lorsqu’une session est supprimée au terme de votre durée de conservation des données. La suppression est irréversible ; téléchargez donc au préalable tout ce que vous devez conserver.- Les documents signés d’une Vérification d’entreprise (KYB) appartiennent à la session de l’entreprise. La suppression de cette session entraîne leur suppression.
- Retirer un document d’un workflow le supprime, avec ses champs et son fichier Word d’origine. Un signataire ayant déjà commencé à signer conserve la copie qui lui a été présentée, dans le cadre de sa session, jusqu’à ce que vous supprimiez cette session. Ne retirez des documents que des workflows sans sessions en attente de signature.
- Une copie que Didit a déjà envoyée par e-mail au signataire se trouve dans sa boîte de réception et n’est pas affectée.
Voir aussi
- Rapport de signature électronique :
signatures[], le PDF signé, le PDF de preuve et les téléchargements. - Avertissements de signature électronique : chaque avertissement et la règle qui le contrôle.
- Créer une session : envoyer des documents, des champs et des valeurs de champs par session.
- Configurations des fonctionnalités de workflow : chaque paramètre de l’étape.