Créer un ordre de paiement par e-mail

Important :

  • Si sendMAIL= true, un e-mail sera reçu par chaque client avec une URL de paiement unique.
  • Si sendMAIL= false, le client ne recevra pas d'e-mail. Le marchand a la charge de lui faire parvenir l'URL de paiement par le canal de son choix.

La fonction create permet de créer un ordre de paiement. Elle prend en entrée les paramètres suivants :

Nom du champ Type Description Requis
info paymentOfferInfo Paramètres de création du paiement (voir paymentOfferInfo)
wsSignature string Signature

Le calcul de la signature se fait en prenant les paramètres dans l’ordre suivant :

shopId, reference, ctxMode, amount, currency, locale, message, recipients, subject, validationMode, validity, sendMail, expandedData

Remarques :

Dans le calcul de la signature :

  • Les champs de type dateTime doivent être formatés en YYYYMMDD.

    Exemple : 2016-06-22T23:00:00+00:00 devient 20160622

  • La chaine du champ recipients doit être entre crochets [...]. Les adresses e-mail devront être séparées d’une virgule et d’un espace.

    Exemples :

    [email]

    [email1, email2, email3]

La fonction create retourne une réponse du type paymentOfferResponse.

Exemple de fichier xml généré

<?xml version="1.0" encoding="UTF-8"?> 
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://www.w3.org/2003/05/soap-envelope"
 xmlns:ns1="http://v2.paymentoffer.ws.vads.lyra.com/">
 <SOAP-ENV:Body> 
	 <ns1:create> 
		 <info> 
			 <shopId>12345678</shopId>
			 <ctxMode>TEST</ctxMode>
			 <subject>Votre ordre de paiement</subject>
			 <message>Bonjour veuillez trouver ci-joint un lien de paiement</message>
			 <device>MAIL</device>
			 <reference>CMD123</reference>
			 <validity>2016-06-22T23:00:00+00:00</validity>
			 <amount>10000</amount>
			 <validationMode>0</validationMode>
			 <currency>978</currency>
			 <locale>fr</locale>
			 <sendMail>true</sendMail>
			 <recipients>test@test.fr</recipients>
			 <recipients>test1@test.fr</recipients>
			 <expandedData>vads_payment_config=MULTI:first=1000;count=3;period=30&vads_language=en</expandedData>
		 </info>
		 <signature>1ee15221a1b9c062e01ba4a790e46581418f72fb</signature>
	 </ns1:create>
 </SOAP-ENV:Body>
 </SOAP-ENV:Envelope>

Calcul de la signature correspondante :

12345678+CMD123+TEST+10000+978+fr+Bonjour veuillez trouver ci-joint un lien de paiement+[test@test.fr, test1@test.fr]+Votre ordre de paiement+0+20160622+1+vads_payment_config=MULTI:first=1000;count=3;period=30;vads_language=en+certificat

Exemple de fichier xml généré avec utilisation d'un template

<?xml version="1.0" encoding="UTF-8"?> 
<soap:Envelope xmlns:soap=""
 xmlns:v2="">
 	<soap:Header/>   
	<soap:Body> 
	 <v2:create> 
		<info>            
			<shopId>12345678</shopId>            
			<ctxMode>TEST</ctxMode>            
			<reference>CMD123</reference>            
			<template>templateTest</template>            
			<device>MAIL</device>            
			<validity>2017-12-10T19:20:00Z</validity>            
			<amount>10000</amount>            
			<validationMode>0</validationMode>           
			<currency>978</currency>          
			 <locale>fr</locale>            
			<sendMail>true</sendMail>            
			<recipients>test@test.fr</recipients>           
			<expandedData>vads_payment_config=MULTI:first=1000;count=3;period=30</expandedData>  
		 </info>
 			<signature>719595eecd97ec87de35fb6973ab425b6d45ab61</signature>
	 </v2:create>
    </soap:Body>
</soap:Envelope>

Calcul de la signature correspondante :

12345678+CMD123+TEST+10000+978+fr+[test@test.fr]+0+20171210+1+vads_payment_config=MULTI:first=1000;count=3;period=30+certificat