Aller au contenu
Documentation

Avec un contact existant

Faire signer votre document à un contact déjà enregistré, en une requête.

2 min de lecture Mise à jour le 9 novembre 2026
cURL
curl -X POST "https://staging-api.docage.com/Transactions/CreateFullTransaction" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
  -F 'Transaction={"Name":"Contrat avec Atelier Lumière","TransactionFiles":[{"FriendlyName":"Contrat","Name":"Contrat de prestation"}],"TransactionMembers":[{"FriendlyName":"Client","MemberRole":0,"SignMode":1}]}' \
  -F "Client=00000000-0000-4000-8000-000000000201" \
  -F "Contrat=@contrat-atelier-lumiere.pdf;type=application/pdf" \
  -F 'Client,Contrat={"Pages":"1","Coordinates":"320,90,180,100"}'
  • Transaction déclare un document « Contrat » et un participant « Client » qui signe (MemberRole 0), son code de signature par email (SignMode 1).
  • Client désigne la personne : l'identifiant d'un contact — ou d'un utilisateur — de Docage. Le participant prend ses coordonnées sur sa fiche.
  • Contrat porte le fichier.
  • Client,Contrat pose l'encart de sa signature : page 1, à 320 points du bord gauche et 90 du bas, 180 de large et 100 de haut. Voir Poser une signature visuelle.

La réponse est le parcours créé et envoyé : le client reçoit son invitation à signer.

Les refus

  • « Aucun contact ou utilisateur trouvé pour le participant Client » : l'identifiant ne désigne aucune fiche.
  • Un message dit que vous n'avez pas le droit de voir le contact ou l'utilisateur lié à « Client » : la fiche existe, mais vous ne la voyez pas.
  • Le contact sans email, sans prénom ou sans nom — ou sans mobile pour un code par SMS — fait refuser l'envoi : le parcours reste en brouillon.

Les pièges

  • Oublier MemberRole laisse le participant sans action : voir Créer un parcours sans modèle.
  • Sans emplacement de signature, la signature est valide, mais aucun encart ne la montre sur le document.
  • La clé Client,Contrat s'écrit comme les identifiants conviviaux, majuscules comprises.