Version	Description
1.0

Cinématique

Cette fonctionnalité permet d'initialiser la signature électronique. Seule la signature d'un mandat de prélèvement est pour le moment disponible.

Pré-requis :

Un mandat de prélèvement a été initialisé avec RegisterSddMandate

Cette fonctionnalité nécessitera ensuite 3 points d'intégration par la MARQUE BLANCHE :

Un appel à SignDocumentInit du DIRECTKIT pour initialiser une demande de signature électronique et obtenir un token
Une redirection du site web de la MARQUE BLANCHE vers le WEBKIT, en passant le token en paramètre GET (voir Finalisation de la signature de document)
Une page de retour sur laquelle l'utilisateur reviendra après la signature électronique

Requête

XML

<SignDocumentInit xmlns="Service_mb">
  <wlLogin>string</wlLogin>
  <wlPass>string</wlPass>
  <language>string</language>
  <version>string</version>
  <walletIp>string</walletIp>
  <walletUa>string</walletUa>
  <wallet>string</wallet>
  <mobileNumber>string</mobileNumber>
  <documentId>string</documentId>
  <documentType>string</documentType>
  <returnUrl>string</returnUrl>
  <errorUrl>string</errorUrl>
</SignDocumentInit>

JSON

{   
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "mobileNumber":"string",
    "documentId":"string",
    "documentType":"string",
    "returnUrl":"string",
    "errorUrl":"string"
}

Element	Description	Requis	Format	Exemple
wallet	Identifiant du wallet	Oui	[0 : 256] car	taxi67
mobileNumber	Nécessaire si aucun numéro de mobile n'a déjà été rattaché au wallet (via RegisterWallet ou UpdateWalletDetails) Le numéro doit être au format MSISDN : numéro international avec code pays, sans le « + » ni « 00 » Même en test, veuillez renseigner un numéro de mobile valide, car le process de signature électronique comprend un envoi de code par SMS.	Dépend	[6 : 30] car	33612345678
documentId	Identifiant du SDD à signer : identifiant obtenu suite à RegisterSddMandate	Oui	int	46
documentType	Mettre à 21 pour signer un mandat SDD.	Oui	int	21
returnUrl	url de retour sur le site de la MARQUE BLANCHE, vers laquelle le WEBKIT redirigera votre utilisateur en cas de réussite de la signature.	Oui	[1 : max] car	https://www.votresite.com/signature_return.php
errorUrl	url de retour sur le site de la MARQUE BLANCHE, vers laquelle le WEBKIT redirigera votre utilisateur en cas d'échec de la signature.	Oui	[1 : max] car	https://www.votresite.com/signature_error.php

Réponse

XML

<?xml version="1.0" encoding="utf-8"?>
<SIGNDOCUMENT>
	<TOKEN>string</TOKEN>
</SIGNDOCUMENT>

JSON

{  
    "SIGNDOCUMENT":{  
        "TOKEN":"string"
    }
}

Element	Description	Exemple
TOKEN	Token de paiement à passer en GET vers l'URL du webkit. Remarque : le token est utilisable tant que le mandat n'est pas correctement signé, donc si l'utilisateur revient sur votre page d'erreur (s'il a annulé par exemple), vous avez toujours la possibilité de soumettre à nouveau ce token au WEBKIT.	63458771evCKM8Wn6GPt44HgcRt56gRerAp

SignDocumentInit : Initialisation de la signature électronique d'un document

Cinématique

Requête

Réponse

Search