Guide d’intégration de la signature électronique de Docage en marque blanche
Faites signer vos documents
sans quitter votre application ou site web
Docage a tout prévu pour que l’intégration de la signature électronique à votre solution soit la plus complète possible. Vous allez pouvoir intégrer les pages de visualisation, de remplissage de formulaire si vos transactions en contiennent, de signature, ainsi que les pages de redirection pour déclencher la suite de vos workflows. Et tout cela avec vos comptes des messagerie pour l’envoi des emails pour que vos utilisateurs restent dans votre écosystème.
C’est parti ! Suivez ces quelques étapes et votre application intégrera une signature électronique eIDAS à vos couleurs !
Créer une organisation au nom de votre société.
- Générez et récupérez votre clé API (onglet Clé API de votre fiche utilisateur).
Choisissez le mode de gestion de vos clients :
- Un seul compte utilisateur pour votre application et toutes les requêtes seront faites avec ce compte.
- Un compte utilisateur par client (société) vous permettant d’utiliser les droits et toutes les fonctions propres aux utilisateurs (comme le remplacement automatique du créateur d’une transaction par exemple).
- Une organisation par client (société) avec chacune son/ses utilisateurs. Vous bénéficiez ainsi d’une parfaite étanchéité des donnés entre vos clients en limitant les risques d’exposer les mauvaises données à un utilisateur de votre application. Dans ce dernier mode il faut demander à devenir « Intégrateur » pour que vous puissiez gérer (avoir des droits) sur vos organisations clients et les facturer directement (au tarif que vous définissez dans Docage pour chaque client). De même ils peuvent utiliser directement votre réserve de crédits ou passer par le système de commandes (onglet Gestion de votre organisation et/ou celle de vos clients).
Configurez les comptes emails (Mailbox) de votre/vos organisation(s)
- Soit via l’interface (Onglet Comptes Emails d’une organisation) ou via l’API. Les emails seront envoyés à partir de votre nom de domaine. Notez qu’un même compte email peut être assigné à plusieurs utilisateurs et/ou organisations. Vidéo sur la configuration de comptes emails.
Dans votre application enregistrez les identifiants de vos utilisateurs (email/clé API)
- Cela vous permettra de faire les requêtes pour le compte du bon utilisateur.
Configurez vos webhooks (facultatif)
- Si vous souhaitez mettre à jour en temps réel le statut de la transaction et/ou des membres. Configuration des webhooks via l’API.
Générez votre transaction via l’API et enregistrez les Ids de la transaction et des membres.
- En configurant correctement les propriétés suivantes :
- Les redirections (et en y insérant des champs dynamiques) pour qu’elles redirigent vers votre site/application. Configuration des redirections via l’API
- Les emails d’invitation pour que les liens pointent vers votre page qui intègre l’iframe Docage (voir ci-dessous).
Pour faire signer un membre dans votre interface :
- Intégrez dans une iframe la page suivante : https://app.docage.com/transactions/Sign?transactionMemberId=xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, c’est vers cette page qu’il faudra que vos liens de vos emails pointent.
Et voilà ! N’hésitez pas à nous poser vos questions si nécessaire via le chat pour des explications supplémentaires sur l’une des étapes.