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 Lemonway, 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 :

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.

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

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).