Finalize document signature

This function is used to sign a document.

How it works

Prequisite: the WHITE BRAND has initialized a document signature using the SignDocumentInit method of DIRECTKIT and has obtained a signature token.

  1. The WHITE BRAND website redirects the user to the WEBKIT with the signature token parameter in the query string.
  2. The WEBKIT checks informations and redirect the user to our signature partner's page.
  3. The signature is done on our partner's page:
    1. The user can see the mandate and make sure the data is correct
    2. The user clicks on "Validate and start signature"
    3. The user is redirected to a page where a signature can be drawn using the mouse. This is not mandatory.
    4. The user receives an SMS with a code
    5. The user types it
    6. After validating, a confirmation message is displayed. The user can click to go back to the WHITE BRAND's return page
  4. The signature is saved, the mandate is automatically validated and is ready to process a SDD

Request

This Request is sent to Lemon Way WEBKIT using the following parameters in the query string :

Variable

Description

Mandatory

Format

Example

signingtoken

Token received in output of SignDocumentInit of DIRECTKIT

Yes

[1:256] char

62612109COhhmoY3kOBhf9O7op8g1m8NE

Examples

<?php
/*
$wkURL : URL of WEBKIT
$signingtoken: Token retrieved from DIRECTKIT
*/
header('Location: '.$wkURL.'?signingtoken='.$signingtoken);
?>

Return

The WHITE BRAND return URL receives 2 different responses:

  • When the CLIENT has successfully signed the document, a notification (callback) is sent from Lemon Way's server to the white brand return URL, with data in POST parameter POST. No notification is sent in case of unsuccessful signature.
  • When the CLIENT terminates its operation, he is redirected to the WHITE BRAND error or return URL, with data in a GET

In both cases, the data in parameter is:

Item

Description

Example

signingtoken

Token received in output of SignDocumentInit of DIRECTKIT

62612109COhhmoY3kOBhf9O7op8g1m8NE