Faire signer un document en ligne est simple en démo, délicat en production. Le sujet, ce sont les états et les webhooks, pas le bouton signer.
Un produit immobilier, RH ou juridique a besoin de faire signer des documents. Les API d'e-signature (Yousign et équivalents) gèrent la valeur légale. L'enjeu d'intégration est ailleurs : la machine à états.
Un document a un cycle de vie
Brouillon, envoyé, en attente de signature, signé, expiré, annulé. Chaque transition doit être reflétée dans votre base, et déclenchée par le fournisseur, pas devinée par l'interface.
Comme pour le paiement, ce sont les webhooks qui font foi. On les sécurise, on les rend idempotents, et on gère le cas où ils arrivent dans le désordre ou en double.
Orchestrer autour de la signature
Une signature déclenche souvent une suite : génération de PDF, email de confirmation, activation d'un accès. Cette orchestration doit être reprenable si une étape échoue, sans renvoyer le document à signer.
La signature n'est qu'un événement dans un flux. C'est le flux qu'on conçoit.