Créer une URL de paiement

La fonction create permet de créer une URL 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 ci dessous)
wsSignature string Signature

Attributs de l'objet paymentOfferInfo

Nom de l'attribut Type Description Requis
shopId Long n8 Identifiant de la boutique.
reference string an24 Référence de la commande générée par le site marchand.  
ctxMode string Contexte de sollicitation de la plateforme de paiement :
  • TEST
  • PRODUCTION
amount long Montant de la commande, exprimé dans l’unité indivisible de la devise ( (le centime pour l'euro) ).
currency int Code de la devise de la transaction (norme ISO 4217).

Ex : 978 pour l'euro (EUR)

locale string Code de la langue d'envoi des notifications (e-mail ou sms de confirmation de paiement)

Liste des langues disponibles

Langue Codification ISO 639-1
Allemand de
Anglais en
Chinois zh
Espagnol es
Français fr
Italien it
Japonais ja
Néerlandais nl
Polonais pl
Portugais pt
Russe ru
Suédois sv
recipients Array [1-100] Liste des adresses e-mails. Laissez le champ vide.
validationMode int Mode de validation des paiements :
  • 0 = Automatique (par défaut)
  • 1 = Manuel.
validity dateTime Date de validité de l’ordre.

Ne peut être antérieure à la date courante et ne peut dépasser 90 jours.

Date exprimée au format ISO 8601 définit par W3C.

Exemple : 2016-07-16T19:20:00Z.

sendMail boolean false.

Permet de générer l'URL de paiement sans envoyer le lien par e-mail à l'acheteur.

expandedData string Permet d’ajouter n’importe quel champ du formulaire de façon dynamique.

Exemples :

Créer un ordre de paiement nfois et en anglais
vads_payment_config=MULTI:first=1000;count=3;period=30&vads_language=en

Proposer l'enregistrement de la carte lors du paiement

vads_page_action=ASK_REGISTER_PAY

Réaliser un paiement en 1 clic

vads_identifier=9685332147463547785213301
 
device string valeur possible = « MAIL »

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

  • Le champ recipients étant envoyé à vide, sa valeur dans le calcul de signature est : []

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

Exemple de requête

<?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>false</sendMail>
      <recipients></recipients>
      <expandedData>vads_payment_config=MULTI:first=1000;count=3;period=30</expandedData>
    </info>
    <signature>1ee15221a1b9c062e01ba4a790e46581418f72fb</signature>
  </ns1:create>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>