Changer le mode de signature d'un participant

Recevoir le code de signature par email plutôt que par SMS, ou changer un autre réglage d'un participant du modèle, pour cet envoi.

2 min de lecture Mise à jour le 9 novembre 2026

Un participant qui signe confirme sa signature par un code de sécurité, reçu par SMS ou par email. Le modèle fixe ce mode ; la clé Transaction le change pour un envoi, sous l'identifiant convivial du participant :

cURL

curl -X POST "https://staging-api.docage.com/Transactions/CreateFullTransaction" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
  -F "TemplateId=aaaaaaaa-0000-4000-8000-000000000001" \
  -F "Client=00000000-0000-4000-8000-000000000201" \
  -F "Contrat=@devis-atelier-lumiere.pdf;type=application/pdf" \
  -F 'Transaction={"TransactionMembers":[{"FriendlyName":"Client","SignMode":1}]}'

SignMode : 0 code par SMS (d'office), 1 code par email. La valeur s'écrit en nombre, en texte ("1") ou par son nom ("Email").

Les autres réglages d'un participant

Dans la même entrée, sous son FriendlyName :

Propriété	Ce qu'elle règle
`Language`	La langue de ses emails et de ses pages : `1` français (d'office), `0` anglais, `2` espagnol, `3` allemand…
`SignatureLevel`	Le niveau de sa signature : `1` avancée (d'office), `3` avancée avec certificat qualifié, `2` qualifiée — ces deux derniers avec un certificat du signataire, sur son poste.
`NotifySignatureInvitationByMail`	`false` : il ne reçoit pas l'email d'invitation à signer.
`NotifyTransactionCompletionByMail`	`false` : il ne reçoit pas l'email de fin du parcours.

Ses actions — signer, valider… — et son identifiant convivial ne se changent pas ainsi : ils sont ceux du modèle.

Les pièges

Un code par SMS part au mobile du participant (Mobile) : sans mobile, il part par email. Une organisation qui n'est pas encore en production ne fait pas signer par SMS : l'envoi est refusé, « choisissez le mode de signature « Email » ».
Un participant qui n'a plus l'email d'invitation n'a pas d'autre accès à sa page : ne l'éteignez que si vous lui transmettez le parcours autrement.
L'identifiant convivial s'écrit tel que le modèle le porte : un nom inconnu est ignoré, sans erreur.