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

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 :

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

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

  
    "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 version="1.0" encoding="utf-8"?>
<SIGNDOCUMENT>
	<TOKEN>string</TOKEN>
</SIGNDOCUMENT>
{  
    "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