Finalisation de la signature de document

Cette fonctionnalité permet de finaliser une signature de document.

Cinématique

Pré-requis : la MARQUE BLANCHE a initialisé un rechargement via la méthode SignDocumentInit du DIRECTKIT. La MARQUE BLANCHE est alors en possession d'un token de signature.

  1. Le site de la MARQUE BLANCHE redirige l'utilisateur vers le WEBKIT de Lemon Way, avec en paramètre dans l'URL le token de signature.
  2. Le WEBKIT effectue des vérifications puis redirige l'utilisateur sur la page de signature de notre partenaire.
  3. La signature a lieu sur la page de notre partenaire :
    1. L'utilisateur peut visualiser le mandat et vérifier que les informations sont correctes
    2. L'utilisateur clique sur « Valider et lancer la signature des fichiers »
    3. L'utilisateur arrive sur une page sur laquelle il peut tracer sa signature à la souris, mais cela n'a pas de valeur juridique, ce n'est donc pas obligatoire
    4. L'utilisateur reçoit un SMS contenant un code
    5. L'utilisateur saisit le code sur la page
    6. Après avoir validé le code, un message de confirmation s'affiche. L'utilisateur peut retourner sur le site de la MARQUE BLANCHE.
  4. La signature est enregistrée, le mandat est validé et prêt à recevoir une première demande de prélèvement.

Requête

La requête est envoyée au WEBKIT de Lemon Way, avec en paramètre  dans l'URL les informations suivantes :

Variable

Description

Requis

Format

Exemple

signingtoken

Token de signature reçu par la MARQUE BLANCHE en sortie de SignDocumentInit du DIRECTKIT

Oui

[1:256] car

62612109COhhmoY3kOBhf9O7op8g1m8NE

Exemples

<?php
/*
$wkURL : URL du WEBKIT de LEMON WAY
$signingToken : Token récupéré via le DIRECTKIT
*/
header('Location: '.$wkURL.'?signingToken='.$signingToken);
?>

Retour

La MARQUE BLANCHE reçoit 2 retours différents (cas typique):

  • Lorsque le CLIENT termine sa signature avec succès, une notification (callback) est envoyée depuis le serveur de Lemon Way sur l'URL de la MARQUE BLANCHE, avec des données en paramètre POST. Aucune notification n'est envoyée en cas d'échec.
  • Lorsque le CLIENT termine son opération, il est redirigé vers l'URL de la MARQUE BLANCHE avec des données en paramètres GET.

Les callbacks sont parfois se répetés et on ne garantie pas l'ordre d'arrivé des notifications (GET/POST).

Que ce soit lors de la notification ou de la redirection, la donnée retournée en paramètre est :

Element

Description

Exemple

signingToken

Token de signature reçu par la MARQUE BLANCHE en sortie de SignDocumentInit du DIRECTKIT

62612109COhhmoY3kOBhf9O7op8g1m8NE

La MARQUE BLANCHE peut appeler GetWalletDetails du DIRECTKIT afin de s'assurer que le mandat est bien validé, mais cela n'est pas obligatoire (si vous émettez une demande de prélèvement sur un mandat non validé, elle sera de toute façon rejetée).