Commencer
Intégrer / SDK
Vérification des utilisateurs
Vérification d'entreprise
Surveillance des transactions
Journal des modificationssignatures[] dans :
GET /v3/session/{sessionId}/decision/, pour les sessions de Vérification des utilisateurs (KYC) et de Vérification d’entreprise (KYB).- La
decisiondes webhooks de session V3, envoyés lorsque la session estApproved,Declined,In ReviewouAbandoned. - L’onglet Signature de la session dans la console, et la section dédiée à la signature du rapport PDF.
signatures n’est présent dans la décision que lorsque le workflow comporte une étape de Signature électronique. Il s’agit d’un tableau vide jusqu’à ce qu’un signataire atteigne cette étape. Une étape KYC comprend un seul élément ; une étape KYB comprend un élément par signataire.
Exemple
L’objet signature
Ne considérez jamais qu’un signataire a signé tant que
status n’est pas signed. Sur une signature avancée (AES), un certificat, un horodatage ou un signed_file à null indique qu’il n’y a pas encore de signature. Une signature simple signée possède un signed_file mais a toujours un certificat et un horodatage à null.
Signataire
Documents
Champs
Chaque élément dedocuments[].fields[] correspond à un champ du document, avec sa valeur sur la copie de ce signataire :
Télécharger les documents signés
Utilisez les chemins fournis danssigned_file et evidence_file avec votre clé API. Chaque route renvoie le PDF lui-même.
Avant de répondre, Didit compare le fichier stocké à son empreinte SHA-256 enregistrée. En cas de différence, les routes du PDF signé et des preuves renvoient
409 et la route de l’image renvoie 400, chacune avec signature_document_changed. Transmettez toujours signature_id à la route des preuves lorsqu’une étape KYB comporte plusieurs signataires.
Le PDF signé
Le PDF signé contient, dans l’ordre :- Les pages du document telles qu’elles ont été présentées au signataire, avec la valeur de chaque champ apposée là où vous l’avez positionnée.
- La page de preuves, sauf si vous avez désactivé
signature_evidence_page. - Pour le niveau Avancé (AES) uniquement, la signature PAdES, avec l’horodatage RFC 3161 émis par Didit et les données de révocation nécessaires pour la valider ultérieurement. Un PDF Simple se termine après la page de preuves et ne comporte ni signature numérique, ni cachet, ni horodatage.
Signed with Didit · suivi des 8 premiers caractères de l’id de la signature.
Didit ajoute les valeurs des champs, la page de preuves et la signature après les octets du document présenté au signataire. Ce document constitue un préfixe exact du fichier signé, ce qui permet de continuer à vérifier sha256_original par rapport au PDF signé.
Le PDF de preuves
Le PDF de preuves consigne, pour un signataire donné :- Le niveau et le format.
- Le nom du signataire, sa capacité de signature et, pour le KYB, l’entreprise.
- La session de vérification d’identité (Avancé (AES) uniquement).
- La confirmation : canal, destination masquée et date/heure (Avancé (AES) uniquement).
- L’adresse IP du signataire.
- Chaque document : titre, nombre de pages et SHA-256 de l’original. Pour un document Word, le nom du fichier Word et son SHA-256, la version du convertisseur et le SHA-256 du PDF.
- La signature adoptée : saisie au clavier (avec son style manuscrit) ou dessinée, le moment où elle a été adoptée, ainsi que les images de la signature et des initiales.
- Chaque champ, par document : son libellé, sa page et son type, sa valeur (l’image pour une signature ou des initiales), la provenance de la valeur (par exemple Saisi par le signataire, Pièce d’identité vérifiée ou Votre API), le moment où il a été renseigné (UTC) et, pour une valeur saisie par le signataire, son adresse IP à cet instant.
- Le consentement final : le texte accepté par le signataire sur l’écran d’examen, ainsi que la date et l’heure.
- Le SHA-256 de chaque fichier signé et, pour le niveau Avancé (AES), le certificat (délivré à, émetteur, numéro de série et validité) et l’horodatage.
Valider à nouveau une signature
POST /v3/session/{session_id}/signatures/{node_id}/validate/ relit chaque PDF signé de l’étape et vérifie son SHA-256. Pour une signature avancée (AES), il valide également la signature PAdES, son certificat, les données de révocation et l’horodatage. Une signature simple ne comporte pas de signature numérique, le contrôle porte donc uniquement sur l’intégrité du fichier. Il enregistre le résultat dans validation et renvoie le tableau signatures[] mis à jour. Envoyez signature_id pour vérifier un seul signataire. Il nécessite write:sessions, et dans la console, il s’agit du bouton Valider à nouveau. Un PDF signé stocké qui ne correspond plus à son sha256_signed renvoie 400 avec signature_document_changed.
Tant que les documents ne sont pas signés, validation est null. Si Didit ne peut pas confirmer l’issue de la signature, validation vaut { "valid": null, "reason": "signature_provider_outcome_unknown", "checked_at" } et status reste à signing jusqu’à sa résolution : traitez-le comme non signé.
Dans le rapport PDF
Le rapport PDF imprime une section consacrée à la signature avec le signataire, la confirmation, le certificat, l’horodatage et les documents accompagnés de leurs hashs. Lorsque les documents contiennent des champs, une page Signature électronique · champs suit, avec un tableau par document : la valeur de chaque champ, les images de la signature et des paraphes, les horodatages et les sources. La section de signature apparaît après la vérification bancaire dans un rapport KYC et après Documents dans un rapport KYB. Transmettezpages=signature pour imprimer uniquement cette section.